> ## 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.

# 주요 리소스

> X 기반으로 개발하는 개발자를 위해 주요 X API 문서, SDK, Postman 컬렉션, 지원 채널, 상태 페이지, 커뮤니티 리소스를 즐겨찾기하세요.

X API 개발을 위해 필수 리소스를 즐겨찾기에 추가하세요.

***

## 문서

<CardGroup cols={2}>
  <Card title="API 레퍼런스" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-code.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=488e23401b19225b89acc0136d242219" href="/x-api/introduction" width="24" height="24" data-path="icons/xds/icon-code.svg">
    파라미터와 예시를 포함한 전체 엔드포인트 문서.
  </Card>

  <Card title="데이터 사전" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-book.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=22ac564792481d14ae36a941546039c8" href="/x-api/fundamentals/data-dictionary" width="24" height="24" data-path="icons/xds/icon-book.svg">
    post, user, media 등의 객체 스키마.
  </Card>

  <Card title="인증" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-key.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=de93497af2dde62afd3a06e896d330f5" href="/resources/fundamentals/authentication/overview" width="24" height="24" data-path="icons/xds/icon-key.svg">
    OAuth 1.0a 및 OAuth 2.0 구현 가이드.
  </Card>

  <Card title="Rate limit" icon="gauge-high" href="/x-api/fundamentals/rate-limits">
    엔드포인트별 제한 및 모범 사례.
  </Card>
</CardGroup>

***

## 도구

| 도구                                                                                                                                    | 설명                  |
| :------------------------------------------------------------------------------------------------------------------------------------ | :------------------ |
| [Developer Console](https://console.x.com)                                                                                            | App, 자격 증명, 결제 관리   |
| [Postman 컬렉션](https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80) | 인터랙티브 API 테스트       |
| [Python SDK](/xdks/python/overview)                                                                                                   | 공식 Python 라이브러리     |
| [TypeScript SDK](/xdks/typescript/overview)                                                                                           | 공식 TypeScript 라이브러리 |
| [OpenAPI 스펙](https://api.x.com/2/openapi.json)                                                                                        | 기계 판독 가능한 API 사양    |

***

## 학습

<CardGroup cols={2}>
  <Card title="튜토리얼" icon="graduation-cap" href="/tutorials">
    일반적인 사용 사례에 대한 단계별 가이드.
  </Card>

  <Card title="샘플 코드" icon="github" href="https://github.com/xdevplatform">
    예제 App 및 코드 샘플.
  </Card>

  <Card title="무엇을 만들까" icon="lightbulb" href="/x-api/what-to-build">
    프로젝트를 위한 아이디어와 영감.
  </Card>

  <Card title="마이그레이션 가이드" icon="route" href="/x-api/migrate/overview">
    v1.1에서 v2로 업그레이드.
  </Card>
</CardGroup>

***

## 커뮤니티 및 지원

<CardGroup cols={2}>
  <Card title="개발자 포럼" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-chat-unread.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=ce6313d8c0b7b4e5363f2ce80b89f7e4" href="https://devcommunity.x.com" width="24" height="24" data-path="icons/xds/icon-chat-unread.svg">
    커뮤니티에서 질문하고 솔루션을 공유하세요.
  </Card>

  <Card title="지원 허브" icon="circle-question" href="https://developer.x.com/en/support">
    FAQ, 문제 해결 및 문의 옵션.
  </Card>

  <Card title="@XDevelopers" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-logo-x.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=53e3153f3b8d6efdad31484ef133b274" href="https://x.com/XDevelopers" width="24" height="24" data-path="icons/xds/icon-logo-x.svg">
    공식 업데이트 및 공지.
  </Card>

  <Card title="@API" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-logo-x.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=53e3153f3b8d6efdad31484ef133b274" href="https://x.com/api" width="24" height="24" data-path="icons/xds/icon-logo-x.svg">
    API 관련 뉴스와 팁.
  </Card>
</CardGroup>

***

## 최신 소식 받기

| 리소스                                                      | 얻을 수 있는 정보        |
| :------------------------------------------------------- | :---------------- |
| [변경 로그](/changelog)                                      | 모든 플랫폼 변경 및 업데이트  |
| [변경 로그 RSS 피드](https://docs.x.com/changelog/rss.xml)     | 피드 리더용 변경 로그 업데이트 |
| [뉴스레터](/newsletter)                                      | 뉴스와 기능에 대한 월간 요약  |
| [포럼 공지사항](https://devcommunity.x.com/c/announcements/22) | 주요 플랫폼 공지         |
| [API 상태](https://developer.x.com/status)                 | 실시간 서비스 가용성       |

<Tip>
  주요 변경사항과 새로운 기능을 놓치지 않도록 [@XDevelopers](https://x.com/XDevelopers)를 팔로우하고 알림을 켜세요.
</Tip>

***

## 빠른 참조

### 응답 구조

모든 v2 응답은 다음 구조를 따릅니다:

```json theme={null}
{
  "data": { ... },      // Primary object(s)
  "includes": { ... },  // Expanded objects (if requested)
  "meta": { ... },      // Pagination info
  "errors": [ ... ]     // Partial errors (if any)
}
```

### 공통 파라미터

| 파라미터               | 용도             |
| :----------------- | :------------- |
| `tweet.fields`     | 특정 post 필드 요청  |
| `user.fields`      | 특정 user 필드 요청  |
| `expansions`       | 관련 객체 포함       |
| `max_results`      | 페이지당 결과 수 제한   |
| `pagination_token` | 이전/다음 페이지 가져오기 |

### 인증 방법

| 방법           | 사용 사례               |
| :----------- | :------------------ |
| Bearer Token | 읽기 전용 공개 데이터        |
| OAuth 2.0    | 세분화된 스코프가 있는 사용자 작업 |
| OAuth 1.0a   | 사용자 작업 (레거시, 전체 권한) |

[전체 인증 가이드 →](/resources/fundamentals/authentication/overview)
