統合ガイド

blocks エンドポイントを統合するための重要な概念とベストプラクティス

このガイドでは、blocks エンドポイントをアプリケーションに統合するために必要な主要な概念を解説します。

---

認証

Blocks のエンドポイントにはユーザー認証が必要です。

Method	Description
OAuth 2.0 Authorization Code with PKCE	新規アプリケーションに推奨されます
OAuth 1.0a User Context	レガシーサポート

App-Only 認証はサポートされていません。必ずユーザーの権限で認証する必要があります。

必要なスコープ (OAuth 2.0)

スコープ	必要となる操作
block.read	ブロック済みアカウントの取得
block.write	アカウントのブロックおよびブロック解除
users.read	block スコープと併用時に必須

---

エンドポイント概要

Method	Endpoint	Description
GET	/2/users/:id/blocking	ブロック済みアカウントのリストを取得
POST	/2/users/:id/blocking	アカウントをブロックする
DELETE	/2/users/:source_user_id/blocking/:target_user_id	アカウントのブロックを解除する

---

フィールドと expansions

既定のレスポンス

{
  "data": [
    {
      "id": "1234567890",
      "name": "Example User",
      "username": "example"
    }
  ]
}

利用可能なフィールド

user.fields

フィールド	説明
created_at	アカウント作成日時
description	ユーザーの自己紹介
profile_image_url	アバターのURL
public_metrics	フォロワー数／フォロー数
verified	認証ステータス

expansions

拡張	説明
pinned_tweet_id	ユーザーが固定表示しているポスト

---

ブロックするとどうなるか

相手ができなくなること

• (ログアウトしていない限り) あなたの投稿を見る
• あなたをフォローする
• あなたにDMを送る
• あなたをリストに追加する
• 写真にあなたをタグ付けする

自分ができなくなること

• 相手の投稿を見る
• 相手をフォローする
• 相手にDMを送る

フォロワーをブロックすると、その相手は自動的にフォロー解除されます。

---

ページネーション

大規模なブロックリストを持つユーザーの場合、結果はページネーション (ページ分割) されます:

cURL

shellscript

# 最初のリクエスト
curl "https://api.x.com/2/users/123/blocking?max_results=100" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

# ページネーション用トークンを使った後続リクエスト
curl "https://api.x.com/2/users/123/blocking?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

---

エラー処理

ステータス	エラー	対処方法
400	無効なリクエスト	ユーザーIDの形式を確認してください
401	未認証	アクセストークンを確認してください
403	アクセス禁止	スコープと権限を確認してください
404	見つかりません	ユーザーが存在しません
429	リクエストが多すぎます	時間をおいて再試行してください

---

次のステップ

クイックスタート

最初のブロックリクエストを送信する

ミュート

ブロックの代わりにユーザーをミュートする

APIリファレンス

エンドポイントの完全なドキュメント

サンプルコード

実行可能なコード例