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

# TypeScript XDK

이전에 Twitter API로 알려졌던 X API를 위한 종합적인 TypeScript SDK로, 스마트 페이지네이션, 다양한 인증 방식, 실시간 스트리밍, 완전한 타입 안전성 등 고급 기능을 제공합니다.

<div id="key-features">
  ## 주요 기능
</div>

* **🔐 Authentication**: 사용자 컨텍스트(OAuth 1.0a, OAuth 2.0) 및 App 전용(Bearer 토큰) 인증
* **🔄 Pagination**: 비동기 이터레이션을 지원하는 자동 페이지네이션
* **📡 Streaming**: 자동 재연결이 포함된 이벤트 기반 스트리밍
* **📚 Type Safety**: 모든 엔드포인트와 매개변수에 대한 완전한 TypeScript 정의
* **🎯 Full X API Support**: 사용자, 포스트, 리스트, 북마크, 커뮤니티 등

<div id="quick-start">
  ## 빠른 시작
</div>

<CodeGroup dropdown>
  ```typescript quickstart.ts theme={null} theme={null}
  import { 
      Client, 
      type ClientConfig,
      type Users
  } from '@xdevplatform/xdk';

  const config: ClientConfig = { bearerToken: 'your-bearer-token' };

  const client: Client = new Client(config);

  async function main(): Promise<void> {
    const userResponse: Users.GetByUsernameResponse = await client.users.getByUsername('XDevelopers');
    const username: string = userResponse.data?.username!;
    console.log(username);
  }

  main();
  ```

  ```javascript quickstart.js theme={null} theme={null}
  import { Client } from '@xdevplatform/xdk';

  const client = new Client({ bearerToken: 'your-bearer-token' });

  const userResponse = await client.users.getByUsername('XDevelopers');
  const username = userResponse.data.username;
  console.log(username);
  ```
</CodeGroup>

<Info>
  JavaScript/TypeScript XDK를 사용하는 자세한 코드 예제는 [code samples GitHub repo](https://github.com/xdevplatform/samples/tree/main/javascript)를 참고하세요.
</Info>

<div id="whats-next">
  ## 다음 단계
</div>

* [Installation Guide](/ko/xdks/typescript/install) - 프로젝트에서 SDK를 설치하고 설정하세요
* [Authentication](/ko/xdks/typescript/authentication) - 다양한 인증 방식에 대해 알아보세요
* [Pagination](/ko/xdks/typescript/pagination) - 데이터 페이지네이션에 대해 알아보세요
* [Streaming](/ko/xdks/typescript/streaming) - 실시간 데이터 스트리밍에 대해 알아보세요
* [API Reference](/ko/xdks/typescript/reference/Client) - 전체 API 참조 문서를 확인하세요