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

# 주요 리소스

> 핵심 문서, 도구 및 커뮤니티 리소스

X API 개발에 꼭 필요한 주요 리소스를 즐겨찾기에 추가해 두세요.

***

<div id="documentation">
  ## 문서
</div>

<CardGroup cols={2}>
  <Card title="API 참조 문서" icon="code" href="/ko/x-api/introduction">
    매개변수와 예제가 포함된 엔드포인트 전체 문서.
  </Card>

  <Card title="데이터 사전" icon="book" href="/ko/x-api/fundamentals/data-dictionary">
    게시물, 사용자, 미디어 등 다양한 객체 스키마.
  </Card>

  <Card title="인증" icon="key" href="/ko/resources/fundamentals/authentication/overview">
    OAuth 1.0a 및 OAuth 2.0 구현 가이드.
  </Card>

  <Card title="요청 한도" icon="gauge-high" href="/ko/x-api/fundamentals/rate-limits">
    엔드포인트별 요청 한도와 모범 사례.
  </Card>
</CardGroup>

***

<div id="tools">
  ## 도구
</div>

| 도구                                                                                                           | 설명                     |
| :----------------------------------------------------------------------------------------------------------- | :--------------------- |
| [Developer Console](https://console.x.com)                                                                   | App, 자격 증명 및 결제를 관리합니다 |
| [Postman Collection](https://app.getpostman.com/run-collection/9956214-784efcda-ed4c-4491-a4c0-a26470a67400) | 대화형 API 테스트            |
| [Python SDK](/ko/xdks/python/overview)                                                                       | 공식 Python 라이브러리        |
| [TypeScript SDK](/ko/xdks/typescript/overview)                                                               | 공식 TypeScript 라이브러리    |
| [OpenAPI Spec](https://api.x.com/2/openapi.json)                                                             | 기계가 읽을 수 있는 API 명세     |

***

<div id="learning">
  ## 학습
</div>

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

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

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

  <Card title="마이그레이션 가이드" icon="route" href="/ko/x-api/migrate/overview">
    v1.1에서 v2로 업그레이드하는 방법을 안내합니다.
  </Card>
</CardGroup>

***

<div id="community-support">
  ## 커뮤니티 & 지원
</div>

<CardGroup cols={2}>
  <Card title="Developer Forum" icon="comments" href="https://devcommunity.x.com">
    커뮤니티에 질문하고 해결 방법을 공유하세요.
  </Card>

  <Card title="Support Hub" icon="circle-question" href="https://developer.x.com/en/support">
    FAQ, 문제 해결 가이드, 문의 채널을 확인하세요.
  </Card>

  <Card title="@XDevelopers" icon="x-twitter" href="https://x.com/XDevelopers">
    공식 업데이트와 공지사항을 확인하세요.
  </Card>

  <Card title="@API" icon="x-twitter" href="https://x.com/api">
    API 관련 소식과 팁을 확인하세요.
  </Card>
</CardGroup>

***

<div id="stay-updated">
  ## 최신 소식 받아보기
</div>

| Resource                                                             | 제공 내용                        |
| :------------------------------------------------------------------- | :--------------------------- |
| [Changelog](/ko/changelog)                                           | 모든 플랫폼 변경 사항과 업데이트           |
| [Newsletter](/ko/newsletter)                                         | 플랫폼 소식과 기능 업데이트를 매달 정리한 뉴스레터 |
| [Forum Announcements](https://devcommunity.x.com/c/announcements/22) | 중요한 플랫폼 공지사항                 |
| [API Status](/ko/status)                                             | 실시간 서비스 가용성 정보               |

<Tip>
  중요 변경 사항과 신규 기능을 놓치지 않으려면 [@XDevelopers](https://x.com/XDevelopers)를 팔로우하고 알림을 켜 두세요.
</Tip>

***

<div id="quick-reference">
  ## 빠른 참고
</div>

<div id="response-structure">
  ### 응답 구조
</div>

모든 v2 응답은 다음과 같은 구조를 가집니다:

```json theme={null}
{
  "data": { ... },      // 기본 객체
  "includes": { ... },  // 확장된 객체(요청 시)
  "meta": { ... },      // 페이지네이션 정보
  "errors": [ ... ]     // 부분 오류(있는 경우)
}
```

<div id="common-parameters">
  ### 공통 매개변수
</div>

| 매개변수               | 용도              |
| :----------------- | :-------------- |
| `tweet.fields`     | 특정 게시물 필드를 요청   |
| `user.fields`      | 특정 사용자 필드를 요청   |
| `expansions`       | 관련 객체를 포함       |
| `max_results`      | 페이지당 결과 수를 제한   |
| `pagination_token` | 다음/이전 페이지를 가져오기 |

<div id="authentication-methods">
  ### 인증 방식
</div>

| 방식         | 사용 사례               |
| :--------- | :------------------ |
| Bearer 토큰  | 읽기 전용 공개 데이터        |
| OAuth 2.0  | 세분화된 권한 범위의 사용자 작업  |
| OAuth 1.0a | 사용자 작업 (레거시, 전체 권한) |

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