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

# API Playground

> 개발 중에 API 크레딧을 소모하지 않고 X API v2 엔드포인트를 테스트할 수 있는 로컬 mock 서버와 예제 요청 및 응답 페이로드를 실행합니다.

[API Playground](https://github.com/xdevplatform/playground)는 X API v2 전체를 시뮬레이션하는 로컬 mock 서버입니다. 실제 API 크레딧을 소모하지 않고도 엔드포인트를 테스트하고 프로토타입을 구축하며 API를 탐색할 수 있습니다.

<Card title="GitHub 저장소" icon="github" href="https://github.com/xdevplatform/playground">
  소스 코드, 릴리스, 전체 문서.
</Card>

***

## 기능

<CardGroup cols={2}>
  <Card title="완전한 API v2 호환성" icon="check">
    모든 엔드포인트를 OpenAPI 스펙을 통한 요청 검증과 실제와 유사한 오류 응답으로 지원합니다.
  </Card>

  <Card title="인터랙티브 웹 UI" icon="browser">
    브라우저에서 테스트할 수 있는 `http://localhost:8080/playground`의 시각적 엔드포인트 탐색기.
  </Card>

  <Card title="크레딧 불필요" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-coins.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=d8b17de3fb4032d86b77606ea95fcb55" width="24" height="24" data-path="icons/xds/icon-coins.svg">
    모든 것이 mock 데이터로 로컬에서 실행됩니다. API 키나 결제가 필요하지 않습니다.
  </Card>

  <Card title="상태 저장 작업" icon="database">
    선택적 파일 지속성이 있는 인메모리 상태. post를 생성한 후 조회할 수 있습니다.
  </Card>
</CardGroup>

***

## 설치

Go 1.21+ 가 필요합니다. 소스에서 설치하거나 [릴리스](https://github.com/xdevplatform/playground/releases)에서 사전 빌드된 바이너리를 다운로드하세요.

<Tabs>
  <Tab title="Go install">
    ```bash theme={null}
    go install github.com/xdevplatform/playground/cmd/playground@latest
    playground start
    ```
  </Tab>

  <Tab title="소스에서 빌드">
    ```bash theme={null}
    git clone https://github.com/xdevplatform/playground.git
    cd playground
    go build -o playground ./cmd/playground
    ./playground start
    ```
  </Tab>
</Tabs>

서버는 기본적으로 `http://localhost:8080`에서 시작됩니다.

***

## 빠른 시작

실제 API에 요청하는 것과 동일하게 요청을 보내세요. bearer 토큰으로 `test_token`을 사용하세요:

```bash title="me" lines wrap icon="terminal" theme={null}
# Look up a user
curl -H "Authorization: Bearer test_token" \
  http://localhost:8080/2/users/me

# Create a post
curl -X POST -H "Authorization: Bearer test_token" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the playground!"}' \
  http://localhost:8080/2/tweets

# Search posts
curl -H "Authorization: Bearer test_token" \
  "http://localhost:8080/2/tweets/search/recent?query=hello"
```

인터랙티브 UI를 사용하려면 브라우저에서 `http://localhost:8080/playground`를 여세요.

***

## 포함된 내용

| 기능             | 설명                             |
| :------------- | :----------------------------- |
| **요청 검증**      | OpenAPI 스펙에 따라 요청을 검증          |
| **실제와 유사한 오류** | 적절한 오류 코드와 메시지를 반환             |
| **스트리밍 지원**    | 시뮬레이션된 스트리밍 엔드포인트              |
| **Rate limit** | 구성 가능한 rate limit 시뮬레이션        |
| **CORS 지원**    | 브라우저 기반 애플리케이션에서 작동            |
| **사용량 추적**     | 시뮬레이션된 결제 및 크레딧 추적 엔드포인트       |
| **상태 지속성**     | `~/.playground/`에서의 선택적 파일 지속성 |

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="xurl" icon="terminal" href="/tools/xurl">
    내장 인증이 포함된 실제 X API용 CLI 도구.
  </Card>

  <Card title="첫 요청 만들기" icon="https://mintcdn.com/x-preview/oR-aRNyj1BKPJtxM/icons/xds/icon-rocket.svg?fit=max&auto=format&n=oR-aRNyj1BKPJtxM&q=85&s=b978d7a9225de31709efbbed5b84e92d" href="/make-your-first-request" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    실제 API를 사용할 준비가 되셨나요? 첫 요청을 만들어 보세요.
  </Card>
</CardGroup>