API Playground

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

GitHub 저장소

소스 코드, 릴리스, 전체 문서.

기능

완전한 API v2 호환성

모든 엔드포인트를 OpenAPI 스펙을 통한 요청 검증과 실제와 유사한 오류 응답으로 지원합니다.

인터랙티브 웹 UI

브라우저에서 테스트할 수 있는 http://localhost:8080/playground의 시각적 엔드포인트 탐색기.

크레딧 불필요

모든 것이 mock 데이터로 로컬에서 실행됩니다. API 키나 결제가 필요하지 않습니다.

상태 저장 작업

선택적 파일 지속성이 있는 인메모리 상태. post를 생성한 후 조회할 수 있습니다.

설치

Go 1.21+ 가 필요합니다. 소스에서 설치하거나 릴리스에서 사전 빌드된 바이너리를 다운로드하세요.

Go install
소스에서 빌드

go install github.com/xdevplatform/playground/cmd/playground@latest
playground start

git clone https://github.com/xdevplatform/playground.git
cd playground
go build -o playground ./cmd/playground
./playground start

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

빠른 시작

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

# 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/`에서의 선택적 파일 지속성

xurl

내장 인증이 포함된 실제 X API용 CLI 도구.

첫 요청 만들기

실제 API를 사용할 준비가 되셨나요? 첫 요청을 만들어 보세요.

Getting Started

Products

Fundamentals

Partners & Customers

Resources

API Playground

GitHub 저장소

기능

완전한 API v2 호환성

인터랙티브 웹 UI

크레딧 불필요

상태 저장 작업

설치

빠른 시작

포함된 내용

관련 항목

xurl

첫 요청 만들기

GitHub 저장소

​기능

완전한 API v2 호환성

인터랙티브 웹 UI

크레딧 불필요

상태 저장 작업

​설치

​빠른 시작

​포함된 내용

​관련 항목

xurl

첫 요청 만들기

기능

설치

빠른 시작

포함된 내용

관련 항목