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

# 連携ガイド

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <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>;
};

このページでは、ピン留めされたリストのエンドポイントを統合するためのツールと主要な概念について説明します。

***

<div id="helpful-tools">
  ## 便利なツール
</div>

このエンドポイントを統合するうえで重要な概念を説明する前に、まず次のツールに慣れておくことをおすすめします。

<div id="postman">
  ### Postman
</div>

Postman は、エンドポイントをテストするのに便利なツールです。各 Postman リクエストには、利用できる項目をすばやく把握できるよう、すべてのパスパラメーターとボディパラメーターが含まれています。Postman コレクションの詳細については、「[Postman の使い方](/ja/tutorials/postman-getting-started)」ページをご覧ください。

<div id="code-samples">
  ### コードサンプル
</div>

このエンドポイントをお好みのプログラミング言語でセットアップするためのコードが必要な場合は、[GitHub ページ](https://github.com/xdevplatform/Twitter-API-v2-sample-code)で、出発点として使えるいくつかのコードサンプルを利用できます。

<div id="third-party-libraries">
  ### サードパーティライブラリ
</div>

コミュニティが提供している [サードパーティライブラリ](/ja/x-api/tools-and-libraries/overview) を活用して、導入をスムーズに進めましょう。v2 エンドポイント向けのライブラリは、対応するバージョンタグを目印に探すことができます。

***

<div id="key-concepts">
  ## 基本概念
</div>

<div id="authentication">
  ### 認証
</div>

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

[OAuth 1.0a User Context](/ja/resources/fundamentals/authentication) を使用するということは、リクエストを正常に行うために、一連の API Key とユーザー Access Token を使用しなければならないことを意味します。Access Token は、リクエストを代理して送信する対象のユーザーに関連付けられている必要があります。別のユーザー向けに Access Token のセットを生成したい場合は、そのユーザーが [3-legged OAuth flow](https://developer.x.com/resources/fundamentals/authentication/obtaining-user-access-tokens) を使ってあなたの App を承認する必要があります。

OAuth 1.0a は扱いが難しいプロトコルである点に注意してください。この認証方式に慣れていない場合は、[ライブラリ](/ja/x-api/tools-and-libraries/overview) を使用するか、または Postman のようなツールを利用することをおすすめします。

<div id="developer-console-projects-and-developer-apps">
  ### 開発者コンソール、Project、および開発者 App
</div>

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

<div id="rate-limits">
  ### レート制限
</div>

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

これらのエンドポイントはユーザーレベルでレート制限されており、あなたが代理でリクエストを行う認証済みユーザーは、どの開発者向け App からであっても、そのエンドポイントを呼び出せる回数が一定数に制限されています。

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

| エンドポイント                              | HTTP メソッド | レート制限              |
| :----------------------------------- | :-------- | :----------------- |
| /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 回のリクエスト |

<div id="fields-and-expansions">
  ### フィールドとexpansions
</div>

X API v2 の GET エンドポイントでは、`fields` と `expansions` と呼ばれる一連のツールを使用して、API から取得したいデータを正確に選択できます。`expansions` パラメータを使用すると、ペイロード内で参照されているオブジェクトを展開できます。たとえば、ピン留めされたリストをルックアップすると、次の [expansions](/ja/x-api/fundamentals/expansions) を取得できます。

* `owner_id`

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

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

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

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