アクセスの取得

API アクセスに申し込み、認証情報を取得する

X API を利用開始するには、サインアップ、App の作成、認証情報の保存という 3 つのステップを実行します。

---

ステップ 1: 開発者アカウントを作成する

1. 開発者コンソールにアクセスする

   console.x.com にアクセスし、Xアカウントでサインインします。

2. Developer Agreement に同意する

   Developer Agreement およびポリシーを確認し、同意します。

3. プロフィールを完了する

   API の利用方法についての基本情報を入力します。

---

ステップ 2: App を作成する

サインアップ後、App を作成して API 認証情報を取得します。

1. 「New App」をクリック

   開発者コンソールのダッシュボードから、新しい App を作成します。

2. App の詳細を入力

   App の名前、説明、利用目的を入力します。

3. 認証情報を生成

   コンソールによって API キーとトークンが生成されます。

---

ステップ 3: 認証情報を保存する

認証要件に応じて、次のような認証情報が発行されます。

Credential	Purpose
API Key & Secret	アプリを識別します。トークンを生成し、OAuth 1.0a リクエストに署名するために使用されます。
ベアラートークン	公開データを読み取るための App 専用認証です。
Access Token & Secret	自分のアカウントを代表してリクエストを送信するために使用します (OAuth 1.0a) 。
Client ID & Secret	ユーザーコンテキストのリクエスト用の OAuth 2.0 認証です。

すぐに保存してください。 認証情報は一度しか表示されません。パスワードマネージャーや安全な保管庫に保存してください。紛失した場合は再発行が必要になり (その際、古い認証情報は無効になります) 、元に戻すことはできません。

---

どの認証情報が必要ですか？

公開データの読み取り

公開データにシンプルに読み取り専用でアクセスするには、ベアラートークン を使用します。

curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

最適な用途: 投稿の検索、ユーザー情報の取得、トレンドの閲覧。

ユーザーとして操作する

ユーザーの代理として操作するには、OAuth 2.0 (推奨) または OAuth 1.0a を使用します。

OAuth 2.0 ではスコープを細かく指定でき、必要な権限だけをリクエストできます。

最適な用途: ポスト、いいね、フォロー、DM へのアクセス。

OAuth 2.0 ガイド →

自分自身として操作する

自分のアカウントとしてリクエストを送信するには、Access Token & Secret を使用します。

これらのトークンは、その App を所有しているアカウントを表します。

最適な用途: テスト、個人ボット、自分用の自動化。

---

認証情報セキュリティのベストプラクティス

環境変数を使用する

ソースコード内に認証情報をハードコードしないでください。

Git にコミットしない

認証情報を含むファイルを .gitignore に追加してください。

定期的にローテーションする

セキュリティ対策として、定期的に認証情報を再生成してください。

最小限のスコープを使用する

App に必要な OAuth 権限だけをリクエストしてください。

---

次のステップ

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

新しい認証情報を使って API を呼び出しましょう。

認証について学ぶ

OAuth 1.0a と OAuth 2.0 について理解を深めましょう。