Documentation Index
Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Postman は、グラフィカルユーザーインターフェイスから API にリクエストを送信できるデスクトップ版および Web 版のアプリケーションです。API の機能を確認・検証したり、アプリケーションの問題をトラブルシューティングしたりする際には、X API、X Ads API、および Labs エンドポイントとあわせて Postman を使用することをおすすめします。
現在、次の 2 つの Postman コレクションを利用できます。
X の Postman コレクションを使い始める前に、利用したい X の開発者プラットフォーム向けツールで、適切なアクセス権と認証情報が付与されていることを確認する必要があります。アクセスの取得については、「はじめに」ページで詳しく確認できます。
開発者アカウントを取得し、developer App を設定し、認証用のキーとトークン一式を用意し、利用を予定している特定の API にリクエストを送信できるよう環境を正しく設定できたら、以下の手順に従って作業を開始できます。
ステップ1: X の Postman コレクションを自分のアカウントに追加する
Step two: 環境変数としてキーとトークンを追加する
| VARIABLE | INITIAL VALUE | CURRENT VALUE |
|---|
| consumer_key | QAktM6W6DF6F7XXXXXX | QAktM6W6DF6F7XXXXXX |
| consumer_secret | AJX560A2Omgwyjr6Mml2esedujnZLHXXXXXX | AJX560A2Omgwyjr6Mml2esedujnZLHXXXXXX |
| access_token | 1995XXXXX-0NGqVhk3s96IX6SgT3H2bbjOPjcyQXXXXXXX | 1995XXXXX-0NGqVhk3s96IX6SgT3H2bbjOPjcyQXXXXXXX |
| token_secret | rHVuh7dgDuJCOGeoe4tndtjKwWiDjBZHLaZXXXXXX | rHVuh7dgDuJCOGeoe4tndtjKwWiDjBZHLaZXXXXXX |
| bearer_token | AAAAAAAAAAAAAAAAAAAAAL9v6AAAAAAA99t03huuqRYg0mpYAAFRbPR3XXXXXXX | AAAAAAAAAAAAAAAAAAAAAL9v6AAAAAAA99t03huuqRYg0mpYAAFRbPR3XXXXXXX |
expansions と tweet.fields クエリパラメータを有効にし、次の値を追加します。
| |
|---|
| Key | Value |
tweet.fields | created_at,attachments |
| expansions | author_id |
id も追加する必要があります。このエンドポイントはポストを返すため、値として有効なポストIDを指定する必要があります。
ポストIDは、x.com にアクセスしてポストをクリックし、URL を確認することで取得できます。たとえば、次の URL のポストIDは 1228393702244134912 です。
https://x.com/XDevelopers/status/1228393702244134912
Paramsタブで、すべてのクエリパラメータをスクロールして「Path Variables」セクションを表示します。ここで、使用したいポストIDを id キーの値として追加します。
このステップの内容をすべて正しく入力できていれば、Paramsタブは次のように表示されるはずです。
ステップ5：リクエストを送信してレスポンスを確認する
{
"data": {
"author_id": "2244994945",
"text": "開発者はバレンタインカードに何と書いたでしょうか？\n \nwhile(true) {\n I = Love(You); \n}",
"id": "1228393702244134912",
"created_at": "2020-02-14T19:00:55.000Z"
},
"includes": {
"users": [
{
"username": "XDevelopers",
"name": "Developers",
"id": "2244994945"
}
]
}
}
Postman を使用したユーザーアクセス・トークンの生成:
OAuth 1.0a を使用してユーザーアクセス・トークンを生成する
OAuth 2.0 を使用してユーザーアクセス・トークンを生成する
- Auth URL - https://x.com/i/oauth2/authorize
- Access Token URL - https://api.x.com/2/oauth2/token
- Client ID - Dev Portal に表示される OAuth 2.0 client ID
- Client Secret - confidential client を使用している場合
- Update Scope - 接続したいエンドポイントに対応する scopes。例: “tweet.read users.read”
- Callback URL (redirect URL とも呼ばれます) 。これは App の認証設定で設定している値と一致している必要があります。
- State - state
準備ができたら、「Get New Access Token」をクリックしてアクセス・トークンを生成します。「問題が発生しました」といったダイアログが表示された場合は、ログインするために戻るボタンを押す必要がある場合があります。ダイアログボックス内の「Authorize app」をクリックして、アプリにアカウントへのアクセスを許可する必要があります。
アプリを承認すると、Postman にリダイレクトされ、そこでトークンを確認し、「Use Token」ボタンを選択して、認可されたユーザーに代わってリクエストの送信を開始できます。
これで、Postman collection を使用する準備が整いました。
Postman で「Code」と書かれたボタンをクリックすると、先ほど作成したリクエストを Python、Node、Ruby などお好みの言語向けのコードに変換できるため、すぐに使い始めることができます。Postman には参考になる優れたドキュメントも用意されています。また、エンドポイントとの統合をより迅速に進めるのに役立つサンプルコードも GitHub にあります。
