> ## 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 엔드포인트를 통합하기 위한 도구와 핵심 개념을 다룹니다. Pinned lists를 다루는 X API v2 standard 티어 레퍼런스입니다.

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 컬렉션에 대해 자세히 알아보려면 ["Postman 사용"](/tutorials/postman-getting-started) 페이지를 참조하세요.

### 코드 샘플

원하는 코딩 언어로 이 엔드포인트를 사용하기 시작하는 데 관심이 있으신가요? [Github 페이지](https://github.com/xdevplatform/Twitter-API-v2-sample-code)에서 시작점으로 활용할 수 있는 다양한 코드 샘플을 제공합니다.

### 서드파티 라이브러리

시작하는 데 도움이 되는 커뮤니티의 [서드파티 라이브러리](/tools-and-libraries) 중 하나를 활용하세요. 올바른 버전 태그를 찾아 v2 엔드포인트에서 동작하는 라이브러리를 찾을 수 있습니다.

***

## 핵심 개념

### 인증

모든 X API v2 엔드포인트는 자격 증명(key와 token이라고도 함) 세트로 요청을 인증해야 합니다. 이 엔드포인트에서는 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 내에서 key와 token을 찾을 수 있습니다.

### Rate limit

매일 수천 명의 개발자가 X API에 요청을 보냅니다. 이러한 요청의 방대한 양을 관리하는 데 도움이 되도록, 각 엔드포인트에는 App 또는 인증된 사용자를 대신하여 요청할 수 있는 횟수를 제한하는 [rate limit](/x-api/fundamentals/rate-limits)이 설정되어 있습니다.

이러한 엔드포인트는 사용자 수준에서 rate limit이 적용됩니다. 즉, 요청을 대신 보내는 인증된 사용자가 어떤 developer App에서도 특정 횟수만큼만 엔드포인트를 호출할 수 있음을 의미합니다.

아래 표는 각 엔드포인트의 rate limit을 보여줍니다.

| 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회 요청 |

### 필드 및 확장

X API v2 GET 엔드포인트에서는 `fields` 및 `expansions`라는 도구 세트를 사용하여 API에서 반환할 데이터를 정확히 선택할 수 있습니다. `expansions` 매개변수를 사용하면 페이로드에서 참조되는 객체를 확장할 수 있습니다. 예를 들어, 고정된 List를 조회할 때 다음 [expansion](/x-api/fundamentals/expansions)을 가져올 수 있습니다:

* `owner_id`

`fields` 매개변수를 사용하면 다양한 데이터 객체 내에서 수신할 [fields](/x-api/fundamentals/fields)를 정확히 선택할 수 있습니다. 이 엔드포인트는 주로 user 객체를 제공합니다. 기본적으로 List 객체는 `id`와 `name` 필드를 반환합니다. `list.created_at` 또는 `list.description`과 같은 추가 필드를 수신하려면 fields 매개변수를 사용하여 명시적으로 요청해야 합니다.

[X API v2 데이터 사전](/x-api/fundamentals/data-dictionary)에 [fields 및 expansions](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions)를 함께 사용하는 방법에 대한 가이드를 추가했습니다.

아래 표는 lookup 엔드포인트에 대해 사용 가능한 필드 및 expansion을 보여줍니다:

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