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

Bookmarks lookup エンドポイントの概要

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

前提条件

このガイドを完了するには、リクエストを認証するための「keys and tokens」が必要です。これらの keys and tokens は、以下の手順で生成できます。
  • 開発者アカウントに登録し、承認を受ける。
  • 開発者ポータルで Project と、それに関連付けられた developer App を作成する。
  • アプリの “Keys and tokens” ページに移動して必要な認証情報を生成する。すべての認証情報は安全な場所に保存すること。

Bookmarks ルックアップリクエストを作成する手順

ステップ1:ツールまたはライブラリを用意する このエンドポイントにリクエストするために使えるツール、コード例、ライブラリはいくつかありますが、ここでは手順を簡素化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。 Postman に X API v2 コレクションを読み込んだら、「Bookmarks」フォルダに移動し、「Bookmarks lookup」を選択します。 ステップ2:リクエストを認証する このエンドポイントに正常にリクエストするには、OAuth 2.0 Authorization Code Flow with PKCE を使用する必要があります。アクセストークンは Postman 内で生成できます。  「Authorization」タブに移動し、「OAuth 2.0」を選択します。 このタブで、次の手順に従ってください。
  1. トークンに名前を付ける
  2. Grant Type に Authorization Code (with PKCE) を選択する
  3. パラメータを更新する: Callback URLhttps://www.example.com これは、開発者ポータルの認証設定ページで設定したコールバック URL と一致している必要があります。 Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - 開発者ポータルから OAuth 2.0 クライアント ID をコピー&ペースト Client Secret - 開発者ポータルから OAuth 2.0 クライアント シークレットをコピー&ペースト。これは、機密クライアントのアプリタイプを使用している場合にのみ必要です。
  4. スコープを次の値に設定する: post.read users.read bookmark.read
  5. state フィールドに「State」と入力する
  6. 「Generate Token」をクリックする
  7. 保存アイコンを押してフォルダの変更を保存する
X にログインしていないというメッセージが表示される場合があります。このエラーが表示された場合は、Postman 内で代理操作しようとしている対象の X アカウントにログインしてください。 ステップ3:ユーザーを指定する このエンドポイントでは、レスポンスを取得したいユーザーの 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に返信して、アプリについて詳しくお聞かせください。"
       }
   ]
}