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

​
Bookmarks 管理用 endpoint のはじめかた

このクイックスタート ガイドでは、Postman を使用して Bookmarks 管理用 endpoint への最初のリクエストを送信する方法を説明します。 さまざまな言語のサンプルコードをご覧になりたい場合は、X API v2 sample code の GitHub リポジトリをご確認ください。
前提条件このガイドを完了するには、リクエストを認証するための keys and tokens のセットが必要です。これらのキーおよびトークンは、次の手順で生成できます。

​
Bookmarks 管理リクエストを作成する手順

ステップ1：ツールまたはライブラリから始める この endpoint にリクエストを送信する方法は複数あります（ツール、コード例、ライブラリなど）。ここでは手順を簡素化するため、Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。
Postman に X API v2 コレクションを読み込んだら、「Bookmarks」フォルダに移動し、「Create a Bookmark」を選択します。 ステップ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 をコピー＆ペースト。これは confidential client の App を使用している場合にのみ必要です。
  4. スコープを次の値に更新する: post.read users.read bookmark.write
  5. state フィールドに “State” と入力する
  6. “Generate Token” をクリックする
  7. 保存アイコンを押してフォルダの変更を保存する
X にログインしていない旨のメッセージが表示される場合があります。このエラーが表示されたら、Postman 内で代理で投稿しようとしている X アカウントにログインする必要があります。 ステップ3：ユーザーを指定する この endpoint では、レスポンスで取得したいフォロワーを持つユーザーのユーザー ID を指定する必要があります。例えば、@XDevelopers のユーザー ID は 2244994945 です。 Postman の「Params」タブに移動し、id パラメータの値として自分自身または認証済みユーザーの ID を入力します。
KeyValue
id2244994945
ステップ4：ブックマークする Post を指定する 「Body」タブに移動し、Bookmarks に保存したい Post の Post ID が目的のものに設定されていることを確認します。JSON ペイロードは以下のようになります。 
      {"tweet_id": "1460323737035677698"}
ステップ5：リクエストを送信し、レスポンスを確認する 設定が整ったら「Send」ボタンをクリックします。次のサンプルと同様のレスポンスが返ってきます。 
{
   "data": {
       "bookmarked": true
   }
}
Post を削除するには、Postman に読み込んだ X API v2 コレクションの「Bookmarks」フォルダー内にある「Remove a Bookmark」リクエストを選択します。まず、代理でリクエストを送信するユーザーのユーザー ID を「id」列の値として指定します。この endpoint では、削除したい Post の ID も必要です。次に「Params」タブで、削除したい Post の ID を「tweet_id」列の値として入力します。  DELETE リクエストが成功すると、次の例のようなレスポンスが返されます。 
{
   "data": {
       "bookmarked": false
   }
}
⌘I