認証ユーザーがブロックしているユーザーの数値型ユーザーIDの配列を取得します。
重要 このメソッドは、指定したページの分だけ情報が表示されます。つまり、全てのブロック情報を漏れなく取得するには、アプリで複数回のリクエストを実行しなければなりません。 カーソリング動作の詳細についてはUsing cursors to navigate collectionsを参照してください。
GET blocks/
|
https://api.twitter.com/1.1/blocks/ids.json
Resource URL
|
Resource Information
Response formats
JSON
Requires authentication?
Yes (user context only)
Rate limited?
Yes
Requests / 15-min window (user auth)
15
|
多くのプログラム環境では桁サイズが原因でTwitterのIDを使用できません。このオプションを設定すると、数値ではなく文字列としてIDを取得します。 詳細については Twitter IDsを読んでください。
サンプル値: true
現在のところ、取得するIDが5000を超えると複数のページに分割されます。 クエリ後にアカウント停止中のユーザーがフィルタされるので、取得されるIDの数は必ず5000になる訳ではありません。 cursor が設定されなかった場合、一番最初のページを表す -1 が設定されたと見なされます。
API からの応答には previous_cursorパラメータと next_cursorパラメータが含まれており、これを使って前後のページを操作できます。詳細情報についてはUsing cursors to navigate collectionsを参照してください。
サンプル値: 12893764510938
Parameters
stringify_ids
optional
Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. Read more about Twitter IDs. Example Values:
cursor
semi-optional
Causes the list of IDs to be broken into pages of no more than 5000 IDs at a time. The number of IDs returned is not guaranteed to be 5000 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of Example Values: |
ログインして登録アプリケーションの一覧を参照してください。
OAuth Signature GeneratorSign in to see a list of your registered applications. |
GET
https://api.twitter.com/1.1/blocks/ids.json?stringify_ids=true&cursor=-1
Example RequestGET
|
{
"ids": [
"123"
],
"next_cursor": 0,
"next_cursor_str": "0",
"previous_cursor": 0,
"previous_cursor_str": "0"
}
Example Result
{
"ids": [
"123"
],
"next_cursor": 0,
"next_cursor_str": "0",
"previous_cursor": 0,
"previous_cursor_str": "0"
}
|