メインコンテンツへスキップ
App は API 認証情報を格納するコンテナです。各 App は独自のキー、トークン、設定を持ちます。

​
App の認証情報

App を作成すると、次の認証情報を生成できます。
CredentialUse case
API Key & SecretOAuth 1.0a で認証します。リクエストに署名したり、ユーザートークンを生成するために使用されます。
Access Token & Secret自分のアカウントとしてリクエストを実行します（OAuth 1.0a）。
Client ID & SecretOAuth 2.0 で認証します。認可コードフローに使用されます。
Bearer Token公開データエンドポイント向けの App 専用認証に使用されます。
新しいプロジェクトには OAuth 2.0 を選択してください。よりきめ細かなスコープを提供し、X API v2 のユーザーコンテキストエンドポイントでは必須です。

​
App の作成

1

開発者コンソールを開く

console.x.com にアクセスしてサインインします。
2

「Create App」をクリック

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

認証情報を生成する

作成後に、必要なキーとトークンを生成します。
4

安全に保管する

認証情報はすぐに保存してください。表示されるのは 1 回だけです。

​
App の権限 (OAuth 1.0a)

OAuth 1.0a の App には 3 種類の権限レベルがあります。
  • 投稿、ユーザー、および公開データを閲覧できます
  • 投稿や「いいね」、その他の変更はできません
  • ダイレクトメッセージにはアクセスできません
権限を変更するには、更新されたスコープを持つ新しいトークンを取得するために、ユーザーに App を再承認してもらう必要があります。

​
OAuth 2.0 App タイプ

OAuth 2.0 を設定する際は、App の種類を選択します。
TypeClientUse case
Web AppConfidential機密情報を安全に保存できるサーバーサイドアプリケーション
Automated App / BotConfidentialサーバー上で動作する Bot や自動化サービス
Native AppPublic機密情報を安全に保持できないモバイルまたはデスクトップアプリ
Single Page AppPublicブラウザベースの JavaScript アプリ
機密クライアント (Confidential clients) には Client Secret が発行されます。パブリッククライアント (Public clients) は PKCE のみを使用します。

​
コールバックURL

コールバックURL（リダイレクトURI）は、OAuth フローで必須です。ユーザーがあなたのAppを承認すると、認可コード付きでコールバックURLにリダイレクトされます。

​
要件

  • 開発者コンソールで App の許可リストにコールバック URL を追加する
  • URL は、末尾のスラッシュも含めて完全に一致している必要がある
  • App ごとに最大 10 個のコールバック URL
  • 本番環境では https:// を使用する
  • ローカル開発では http://127.0.0.1 を使用する（localhost ではない）

​
禁止されているプロトコル

次のプロトコルは使用できません：javascript、data、file、ftp、mailto、telnet、およびその他の非標準スキーム。
vbscript, javascript, vbs, data, mocha, keyword, livescript, ftp, file, gopher, acrobat, callto, daap, itpc, itms, firefoxurl, hcp, ldap, mailto, mmst, mmsu, msbd, rtsp, mso-offdap, snews, news, nntp, outlook, stssync, rlogin, telnet, tn3270, shell, sip

​
ベストプラクティス

アプリを分けて使用する

開発・ステージング・本番用にそれぞれ異なるアプリを作成してください。

認証情報を定期的に更新する

キーは定期的に、また侵害が疑われる場合には直ちに再生成してください。

最小限の権限

アプリが実際に必要とする権限だけをリクエストしてください。

利用状況を監視する

開発者コンソールを定期的に確認し、API の利用状況を把握してください。

​
自動アカウントラベル

App がボットアカウントを運用している場合、そのアカウントに自動アカウントラベルを付与できます。
  1. ボットアカウントの 設定 に移動します
  2. あなたのアカウント → 自動化 を選択します
  3. 管理用アカウントをリンクします
これにより、ユーザーからの信頼が高まり、ボットアカウントをスパムと区別しやすくなります。

​
トラブルシューティング

コールバック URL が、開発者コンソールに登録されているものと完全に一致していることを確認してください（プロトコルや末尾のスラッシュも含みます）。クエリパラメーターとして渡す際は、その URL を URL エンコードしてください。
{
  "errors": [{
    "code": 415,
    "message": "Callback URL not approved for this client application."
  }]
}
App が凍結されている場合は、X プラットフォームチームからの通知メールが届いていないか確認してください。異議申し立てには Platform Help Form を使用してください。