サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳




GET blocks/ids

認証ユーザーがブロックしているユーザーの数値型ユーザーIDの配列を取得します。

重要 このメソッドは、指定したページの分だけ情報が表示されます。つまり、全てのブロック情報を漏れなく取得するには、アプリで複数回のリクエストを実行しなければなりません。 カーソリング動作の詳細についてはUsing cursors to navigate collectionsを参照してください。



リソースURL

https://api.twitter.com/1.1/blocks/ids.json



リソース

応答形式
JSON
認証は必要ですか?
はい (user context only)
レート制限はありますか?
はい
リクエスト回数 / 15秒 window (ユーザー認証の場合)
15


パラメータ

stringify_ids 任意

多くのプログラム環境では桁サイズが原因でTwitterのIDを使用できません。このオプションを設定すると、数値ではなく文字列としてIDを取得します。 詳細については Twitter IDsを読んでください。

サンプル値: true

cursor 半分任意

現在のところ、取得するIDが5000を超えると複数のページに分割されます。 クエリ後にアカウント停止中のユーザーがフィルタされるので、取得されるIDの数は必ず5000になる訳ではありません。 cursor が設定されなかった場合、一番最初のページを表す -1 が設定されたと見なされます。

API からの応答には previous_cursorパラメータと next_cursorパラメータが含まれており、これを使って前後のページを操作できます。詳細情報についてはUsing cursors to navigate collectionsを参照してください。

サンプル値: 12893764510938



OAuth 署名ジェネレータ

ログインして登録アプリケーションの一覧を参照してください。



リクエスト例

GET

https://api.twitter.com/1.1/blocks/ids.json?stringify_ids=true&cursor=-1

応答結果例

{
  "ids": [
    "123"
  ],
  "next_cursor": 0,
  "next_cursor_str": "0",
  "previous_cursor": 0,
  "previous_cursor_str": "0"
}