> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 連携ガイド

> このページでは、pinned Lists エンドポイントを連携するためのツールと主要な概念について説明します。X API v2 スタンダード階層の pinned lists に関するリファレンスドキュメントです。

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

このページでは、pinned Lists エンドポイントを連携するためのツールと主要な概念について説明します。

## 便利なツール

このエンドポイントの連携に役立ついくつかの主要な概念に進む前に、まず以下について理解しておくことをおすすめします:

### Postman

Postman はエンドポイントをテストするのに便利なツールです。それぞれの Postman リクエストには、利用可能なパスパラメータやボディパラメータがすべて含まれており、何が利用できるかを素早く把握できます。Postman コレクションの詳細については、[「Using Postman」](/tutorials/postman-getting-started) ページをご確認ください。

### コードサンプル

このエンドポイントをお好きなプログラミング言語のコードで動かしてみたいですか?出発点として利用できるいくつかの異なるコードサンプルが [Github ページ](https://github.com/xdevplatform/Twitter-API-v2-sample-code) で公開されています。

### サードパーティライブラリ

コミュニティ提供の[サードパーティライブラリ](/tools-and-libraries)を活用して、開発を始めましょう。適切なバージョンタグを検索することで、v2 エンドポイントに対応したライブラリを見つけられます。

***

## 主要な概念

### 認証

すべての X API v2 エンドポイントでは、キーとトークンと呼ばれる認証情報でリクエストを認証する必要があります。このエンドポイントへのリクエストには OAuth 1.0a User Context を利用して認証できます。

[OAuth 1.0a User Context](/resources/fundamentals/authentication) を利用する場合、成功するリクエストを行うために API Key とユーザー Access Token のセットを使用する必要があります。access token はリクエストを代行するユーザーに紐づいている必要があります。他のユーザーのために access token を生成したい場合は、そのユーザーは [3-legged OAuth フロー](https://developer.x.com/resources/fundamentals/authentication/obtaining-user-access-tokens)を通じて App を承認する必要があります。

OAuth 1.0a は扱いが難しい場合があります。この認証方式に不慣れな場合は、[ライブラリ](/tools-and-libraries)や Postman のようなツールの利用をおすすめします。

### Developer Console、Project、developer App

X API v2 エンドポイントで動作する認証情報を取得するには、[developer account に登録](https://developer.x.com/en/portal/petition/essential/basic-info)し、そのアカウント内で [Project](/resources/fundamentals/developer-apps) を設定し、その Project 内で [developer App](/resources/fundamentals/developer-apps) を作成する必要があります。その後、developer App 内でキーとトークンを確認できます。

### レート制限

日々、何千人もの開発者が X API へリクエストを送信しています。この膨大なリクエスト量を管理するために、各エンドポイントには[レート制限](/x-api/fundamentals/rate-limits)が設定されており、App の代理として、または認証済みユーザーの代理として実行できるリクエスト数が制限されます。

これらのエンドポイントはユーザーレベルでレート制限されており、リクエストを代行する認証済みユーザーは、任意の developer App を横断して、それぞれのエンドポイントを一定回数までしか呼び出せません。

以下の表は各エンドポイントのレート制限を示しています。

| Endpoint                             | HTTP method | Rate limit       |
| :----------------------------------- | :---------- | :--------------- |
| /2/users/:id/pinned\_lists           | POST        | 15 分あたり 50 リクエスト |
| /2/users/:id/pinned\_lists/:list\_id | DELETE      | 15 分あたり 50 リクエスト |
| /2/users/:id/pinned\_lists           | GET         | 15 分あたり 15 リクエスト |

### Fields と expansions

X API v2 の GET エンドポイントでは、`fields` と `expansions` と呼ばれるツールを使って、API から返すデータを正確に選択できます。`expansions` パラメータは、ペイロード内で参照されるオブジェクトを展開できるようにします。たとえば、pinned Lists のルックアップでは以下の [expansions](/x-api/fundamentals/expansions) を取得できます:

* `owner_id`

`fields` パラメータでは、異なるデータオブジェクト内のどの[フィールド](/x-api/fundamentals/fields)を受け取るかを正確に選択できます。このエンドポイントは主にユーザーオブジェクトを返します。デフォルトでは、List オブジェクトは `id` と `name` フィールドを返します。`list.created_at` や `list.description` などの追加フィールドを受け取るには、fields パラメータで明示的にリクエストする必要があります。

[fields と expansions](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions) を組み合わせて使用するためのガイドを [X API v2 データディクショナリ](/x-api/fundamentals/data-dictionary)に追加しました。

以下の表は lookup エンドポイントで利用可能なフィールドと expansions を示しています:

| Endpoint                   | Fields                       | Expansions |
| :------------------------- | :--------------------------- | :--------- |
| /2/users/:id/pinned\_lists | `list.fields`, `user.fields` | `owner_id` |