メインコンテンツへスキップ
ご注意: このガイドでは、クイックスタート ガイドの概要で示された前提条件を完了していることを前提としています。

​
ピン留めされた List のルックアップリクエストを作成する手順

ステップ1：Postman で List の endpoint コレクションを選択する Postman に X API v2 コレクションを読み込んだら、“List” フォルダーに移動し、次に “Pinned Lists” フォルダーを選択し、その後に “User’s pinned Lists” を選びます。   ステップ2：ユーザーを特定して指定する ユーザーのピン留めされた List を取得するには、リクエスト内でそのユーザーのユーザー ID を指定する必要があります。ユーザー ID は認証に使用しているユーザーの ID と一致している必要があります。つまり、リクエストを認証する際には、そのユーザー ID に関連付けられた Access Tokens を渡す必要があります。この例では、自分のユーザーに属する ID を指定できます。ID は次の2つの方法で確認できます。
  1. users lookup の username endpoint を使用して、username を渡すと id フィールドを取得できます。
  2. Access Token を確認すると、数値部分があなたのユーザー ID です。
Postman で “Params” タブに移動し、このユーザー ID を id パラメータの “Value” 列に入力します。
KeyValue
id2244994945 (user ID)
ステップ3：取得したい fields を特定して指定する このステップまで完了した状態で “Send” ボタンをクリックすると、レスポンスにはデフォルトの List object の fields である id と name が含まれます。 id と name 以外の追加の fields を取得したい場合は、リクエストで fields および/または expansions パラメータを指定する必要があります。 この演習では、異なるオブジェクトから3つの追加の fields セットをリクエストします。
  • プライマリの List オブジェクトに対する追加の follower_count field
  • expansions パラメータを使用して取得する完全な user object
  • 関連するユーザーオブジェクトに対する追加の tweet.created_at field
Postman で “Params” タブに移動し、“Query Params” テーブルに次の key:value ペアを追加します。
KeyValueReturned fields
list.fieldsfollower_countfollower_count
expansionsowner_idincludes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fieldscreated_atincludes.users.created_at
これで “Send” ボタンの横に次のような URL が表示されるはずです。 https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at ステップ4：リクエストを送信し、レスポンスを確認する すべての設定が完了したら、“Send” ボタンを押して、次のサンプルに類似したレスポンスを受け取ります。 
{
  "data": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "テストリスト",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}
⌘I