メインコンテンツへスキップ

​
Bookmarks 参照 endpoint のはじめかた

このクイックスタート ガイドでは、Postman を使って、Bookmarks 参照 endpoint に初めてリクエストを送信する方法を説明します。 さまざまな言語のサンプルコードを確認したい場合は、X API v2 サンプルコード の GitHub リポジトリをご覧ください。

​
前提条件

このガイドを完了するには、リクエストの認証に使用する keys and tokens が必要です。これらのキーおよびトークンは、次の手順で生成できます。
  • デベロッパーアカウントに登録し、承認を受けます。
  • developer portal で Project と、それに関連付けられた 開発者用 App を作成します。
  • App の「Keys and tokens」ページに移動して、必要な認証情報を生成します。すべての認証情報は安全な場所に保存してください。

​
Bookmarks lookup リクエストを構築する手順

ステップ1: ツールまたはライブラリを用意する この endpoint にリクエストを送るために使用できるツール、コード例、ライブラリはいくつかありますが、ここでは手順を簡素化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください:
Postman に X API v2 コレクションを読み込んだら、「Bookmarks」フォルダに移動し、「Bookmarks lookup」を選択します。 ステップ2: リクエストを認証する この endpoint に正常にリクエストするには、OAuth 2.0 Authorization Code Flow with PKCE を使用する必要があります。Postman 内で access token を生成できます。  「Authorization」タブに移動し、「OAuth 2.0」を選択します。 このタブで、次の手順に従ってください:
  1. トークンに名前を付ける
  2. Grant Type として Authorization Code (with PKCE) を選択する
  3. パラメータを更新する: Callback URL - https://www.example.com これは developer portal の認証設定ページで設定したコールバック URL と一致している必要があります。 Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - developer portal から OAuth 2.0 client ID をコピー＆ペースト Client Secret - developer portal から OAuth 2.0 client secret をコピー＆ペースト。これは機密クライアントの App タイプを使用している場合にのみ必要です。
  4. スコープを次の値に設定する: post.read users.read bookmark.read
  5. state フィールドに「State」と入力する
  6. 「Generate Token」をクリックする
  7. 保存アイコンを押してフォルダの変更を保存する
X にログインしていないというメッセージが表示される場合があります。このエラーが発生した場合は、Postman 内で代理して操作しようとしている X アカウントにログインする必要があります。 ステップ3: ユーザーを指定する この endpoint では、レスポンスを取得したいユーザーのユーザー ID を指定する必要があります。たとえば、@XDevelopers のユーザー ID は 2244994945 です。Postman で「Params」タブに移動し、id パラメータの値として、あなた自身または認可済みユーザーの ID を入力します。
KeyValue
id2244994945
ステップ4: リクエストを送信し、レスポンスを確認する セットアップが完了したら、「Send」ボタンを押すと、次のサンプルレスポンスに類似したレスポンスを受け取ります: 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 X APIを使ってプロジェクトを構築し、コミュニティと共有したいですか？ぜひお聞かせください。あなたのプロジェクトをシェアしてください！"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 これは開発者のイノベーションがTwitterをより良い場所にする方法の一例です。開発者コミュニティが構築したその他のすぐに使えるツールは、こちらのTwitter Toolboxでご確認いただけます ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣今日は重要な日です！\n私たちは@Jigsawと提携してこの新しいツールをローンチしました。この協力により、NGOや非営利団体は、支援するコミュニティのニーズと好みに対応し、人々がTwitterで安全に過ごせるようにするツールを構築できます。詳細はこちら ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "明日、タイムラインのカスタマイズと開発者への活用方法について継続的な議論を行います。ぜひご参加ください。来週予定されているさらなるSpacesもお楽しみに。👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "開発者のイノベーションは、危機の時代においても常に重要です。人々をつなげ、安全を守り、世界と情報を共有するツールを構築している方は、私たちがサポートします。あなたのアプリについて詳しく教えてください。このTweetに返信してお聞かせください。"
       }
   ]
}
⌘I