統合ガイド

このページでは、manage Posts エンドポイントをシステムに統合するためのツールと重要な概念を扱います。

役立つツール

このエンドポイントの統合に役立つ重要な概念に入る前に、以下について理解しておくことをお勧めします:

Postman

Postman は、エンドポイントをテストするのに最適なツールです。各 Postman リクエストにはすべてのパスパラメーターとボディパラメーターが含まれており、利用可能なオプションを素早く把握するのに役立ちます。当社の Postman コレクションについて詳しくは、「Postman を使う」ページをご覧ください。

コードサンプル

お好みのプログラミング言語でこのエンドポイントをセットアップしてみませんか?出発点として利用できるさまざまなコードサンプルを GitHub ページで公開しています。

サードパーティ製ライブラリ

コミュニティによるサードパーティ製ライブラリを活用して開発を始められます。適切なバージョンタグを探すことで、v2 エンドポイントに対応したライブラリを見つけられます。

重要な概念

認証

すべての X API v2 エンドポイントでは、キーとトークン(認証情報)を使ってリクエストを認証する必要があります。これらのエンドポイントでは OAuth 1.0a User Context の使用が必須です。つまり、リクエストを成功させるには API キーとユーザーアクセストークンのセットを使用する必要があります。アクセストークンは、リクエストの代理として行うユーザーに関連付けられている必要があります。他のユーザーのアクセストークンを生成するには、そのユーザーが 3-legged OAuth フローを使用して App を承認または認証する必要があります。 OAuth 1.0a は使いにくい場合がある点にご注意ください。この認証方式に不慣れな場合は、ライブラリを使用するか、Postman のようなツールを使うか、リクエストの認証に OAuth 2.0 を使用することをお勧めします。 OAuth 2.0 Authorization Code with PKCE は、アプリケーションのスコープに対するより詳細な制御を可能にし、複数デバイス間の認可フローに対応します。OAuth 2.0 では、ユーザーの代理としての特定の権限を付与する詳細なスコープを選択できます。 App で OAuth 2.0 を有効にするには、Developer Console の App 設定セクションにある App の認証設定で有効化する必要があります。

Developer Console、Project、開発者 App

X API v2 エンドポイントで機能する認証情報を取得するには、開発者アカウントを所有し、そのアカウント内に Project を設定し、その Project 内に開発者 App を作成する必要があります。その後、開発者 App 内のキーとトークンを取得できます。

投稿作成の制限(セルフサーブ)

以下の制限はセルフサーブ(Pay Per Use)API のお客様にのみ適用されます。Enterprise API のお客様はこれらの制限を受けません。 返信の制限 API 経由の返信は、返信するアカウントが元投稿の作成者から明示的に呼び出された場合にのみ許可されます。つまり、以下のいずれかが真である必要があります:

元の作成者が投稿内で返信ユーザー/アカウントに @ メンションしている。
元の作成者が返信ユーザー/アカウントの投稿を引用している。

いずれの条件も満たされない場合、返信リクエストは拒否されます。 Cashtag 制限 API 経由で作成される投稿は、1 投稿あたり最大 1 つの cashtag(例: $TICKER)に制限されます。2 つ以上の cashtag を含むリクエストは拒否されます。

レート制限

毎日、数千人の開発者が X API にリクエストを送信しています。膨大なリクエスト量を管理するため、各エンドポイントにはレート制限が設定されており、App または認証済みユーザーの代理として送信できるリクエスト数を制限しています。これらのエンドポイントはユーザーレベルでレート制限されます。つまり、リクエストの代理として実行される認証ユーザーは、任意の開発者 App を通じて特定回数だけこのエンドポイントを呼び出せます。POST メソッドには、ユーザーごとに 15 分あたり 200 リクエストのレート制限があります。DELETE メソッドには、15 分あたり 50 リクエストのレート制限があります。さらに、manage Posts または manage Retweets で作成された投稿を含めて、3 時間あたり 300 リクエストの制限があります。

Source label

アプリ名とウェブサイト URL は、アプリケーションによってプログラム的に作成された投稿のメタデータで source label として表示されます。X App のユースケースを変更する場合は、Developer Terms に準拠していることを確認するため、これらの設定内のユースケースも忘れずに更新してください。

プロフィール設定

プロフィール設定で geo が有効になっている場合にのみ、投稿に場所を追加できます。geo が有効になっていない場合、リクエストボディに location パラメーターを追加できますが、投稿には添付されません。画像のユーザータグ付けも同様で、タグ付けしようとしているユーザーが写真タグ付けを有効にしていない場合、投稿は正常に作成されても、そのユーザー名はタグ付きユーザーのリストに表示されません。

投稿へのメディアの追加

現在、X API の v2 を使ってメディアを完全にアップロードする方法はありません。ただし、以前にアップロードしたメディアを投稿に添付することはできます。メディアアップロードエンドポイントまたは X Media Studio で既にアップロード済みのメディア ID を使用できます。これらのメディア ID は自分自身のもの、または認証ユーザーのものである必要があります。

コード例

投稿を作成する

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 投稿を作成する
response = client.posts.create(text="Hello world!")
print(f"Created Post: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 投稿を作成する
const response = await client.posts.create({ text: "Hello world!" });
console.log(`Created Post: ${response.data?.id}`);

返信を作成する

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"text": "This is a reply!", "reply": {"in_reply_to_tweet_id": "1234567890"}}'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 返信を作成する
response = client.posts.create(
    text="This is a reply!",
    reply={"in_reply_to_tweet_id": "1234567890"}
)
print(f"Created reply: {response.data.id}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 返信を作成する
const response = await client.posts.create({
  text: "This is a reply!",
  reply: { inReplyToTweetId: "1234567890" },
});
console.log(`Created reply: ${response.data?.id}`);

投稿を削除する

cURL

curl -X DELETE "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: OAuth ..."

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# 投稿を削除する
response = client.posts.delete("1234567890")
print(f"Deleted: {response.data.deleted}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// 投稿を削除する
const response = await client.posts.delete("1234567890");
console.log(`Deleted: ${response.data?.deleted}`);

次のステップ API リファレンス

Getting Started

Products

Fundamentals

Partners & Customers

Resources

役立つツール

Postman

コードサンプル

サードパーティ製ライブラリ

重要な概念

認証

Developer Console、Project、開発者 App

投稿作成の制限(セルフサーブ)

レート制限

Source label

プロフィール設定

投稿へのメディアの追加

コード例

投稿を作成する

返信を作成する

投稿を削除する

​役立つツール

​Postman

​コードサンプル

​サードパーティ製ライブラリ

​重要な概念

​認証

​Developer Console、Project、開発者 App

​投稿作成の制限(セルフサーブ)

​レート制限

​Source label

​プロフィール設定

​投稿へのメディアの追加

​コード例

​投稿を作成する

​返信を作成する

​投稿を削除する

役立つツール

Postman

コードサンプル

サードパーティ製ライブラリ

重要な概念

認証

Developer Console、Project、開発者 App

投稿作成の制限(セルフサーブ)

レート制限

Source label

プロフィール設定

投稿へのメディアの追加

コード例

投稿を作成する

返信を作成する

投稿を削除する