ブックマークの管理

​

Bookmarks 管理エンドポイントのはじめ方

このクイックスタートガイドでは、Postman を使用して Bookmarks 管理エンドポイントへの最初のリクエストを送信する方法を説明します。

さまざまな言語のサンプルコードをご覧になりたい場合は、GitHub の X API v2 sample code リポジトリをご参照ください。

前提条件

このガイドを完了するには、リクエストを認証するための keys and tokens が必要です。これらの keys and tokens は、以下の手順で生成できます。

• 開発者アカウントにサインアップ し、承認を受ける。
• 開発者ポータルで、Project と関連付けられた developer App を作成する。
• アプリの「Keys and tokens」ページに移動して、必要な認証情報を生成する。すべての認証情報は安全な場所に保存すること。

​

ブックマーク管理リクエストを構築する手順

ステップ1: ツールまたはライブラリから始める

このエンドポイントにリクエストする方法はいくつかありますが、ここでは手順を簡単にするために Postman を使用します。

X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください:

X API v2 を Postman に追加

Postman に X API v2 コレクションを読み込んだら、「Bookmarks」フォルダに移動し、「Create a Bookmark」を選択します。

ステップ2: リクエストを認証する

このエンドポイントに正常にリクエストするには、OAuth 2.0 Authorization Code Flow with PKCE を使用する必要があります。アクセストークンは Postman 内で生成できます。

「Authorization」タブに移動し、「OAuth 2.0」を選択します。

このタブで、次の手順に従ってください:

1. トークンに名前を付ける

2. Grant Type に Authorization Code (with PKCE) を選択する

3. パラメータを更新する:

   Callback URL - https://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 Client ID をコピー＆ペースト

   Client Secret - 開発者ポータルから OAuth 2.0 Client Secret をコピー＆ペースト。機密クライアントのアプリタイプを使用している場合にのみ必要です。

4. スコープを次の値に更新する: post.read users.read bookmark.write

5. state フィールドに「State」を設定する

6. 「Generate Token」をクリックする

7. 保存アイコンを押してフォルダの変更を保存する

X にログインしていないというメッセージが表示されることがあります。このエラーが表示された場合は、Postman 内で代理投稿先となる X アカウントにログインしてください。

ステップ3: ユーザーを指定する

このエンドポイントでは、レスポンスで取得したいフォロワーを持つユーザーの ID を指定する必要があります。たとえば、@XDevelopers のユーザー ID は 2244994945 です。

Postman で「Params」タブに移動し、id パラメータの値にあなた自身または認証済みユーザーの ID を入力します。

	Key	Value
	id	2244994945

ステップ4: ブックマークする Post を指定する

「Body」タブに移動し、ブックマークに保存したい Post の ID が設定されていることを確認してください。JSON ペイロードは以下のようになります。

      {"tweet_id": "1460323737035677698"}

ステップ5：リクエストを送信し、レスポンスを確認する

準備が整ったら「Send」ボタンをクリックします。次の例のようなレスポンスが返ってきます。

{
   "data": {
       "bookmarked": true
   }
}

Post を削除するには、Postman に読み込んだ X API v2 コレクションの “Bookmarks” フォルダーにある “Remove a Bookmark” リクエストを選択します。まず、代理でリクエストを送信するユーザーのユーザー ID を “id” 列の値として指定します。このエンドポイントでは、削除したい Post の ID も必要です。続いて “Params” タブで、削除したい Post の ID を “tweet_id” 列の値として入力します。 

削除リクエストが成功すると、次の例のようなレスポンスが返されます。

{
   "data": {
       "bookmarked": false
   }
}