API Playground

O API Playground é um servidor mock local que simula toda a X API v2. Teste endpoints, construa protótipos e explore a API sem consumir créditos reais.

Repositório no GitHub

Código-fonte, releases e documentação completa.

Recursos

Compatibilidade total com a API v2

Todos os endpoints suportados com validação de requisições via specs OpenAPI e respostas de erro realistas.

Interface web interativa

Explorador visual de endpoints em http://localhost:8080/playground para testar no navegador.

Sem créditos necessários

Tudo roda localmente com dados mock — sem necessidade de chaves de API ou faturamento.

Operações com estado

Estado em memória com persistência opcional em arquivo. Crie posts e depois faça lookup.

Instalação

Requer Go 1.21+. Instale a partir do código-fonte ou baixe um binário pré-compilado dos releases.

Go install
Build a partir do código-fonte

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

O servidor inicia em http://localhost:8080 por padrão.

Início rápido

Faça requisições como faria para a API real — use test_token como seu bearer token:

# Fazer lookup de um usuário
curl -H "Authorization: Bearer test_token" \
  http://localhost:8080/2/users/me

# Criar um 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

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

Abra http://localhost:8080/playground no seu navegador para a interface interativa.

O que está incluído

Recurso	Descrição
Validação de requisições	Valida requisições conforme a spec OpenAPI
Erros realistas	Retorna códigos e mensagens de erro adequados
Suporte a streaming	Endpoints de streaming simulados
Rate limiting	Simulação configurável de rate limits
Suporte a CORS	Funciona com aplicações baseadas em navegador
Rastreamento de uso	Endpoints simulados de faturamento e rastreamento de créditos
Persistência de estado	Persistência opcional em arquivo em `~/.playground/`

Getting Started

Products

Fundamentals

Partners & Customers

Resources

API Playground

Repositório no GitHub

Recursos

Compatibilidade total com a API v2

Interface web interativa

Sem créditos necessários

Operações com estado

Instalação

Início rápido

O que está incluído

Relacionados

xurl

Faça sua primeira requisição

Repositório no GitHub

​Recursos

Compatibilidade total com a API v2

Interface web interativa

Sem créditos necessários

Operações com estado

​Instalação

​Início rápido

​O que está incluído

​Relacionados

xurl

Faça sua primeira requisição

Recursos

Instalação

Início rápido

O que está incluído

Relacionados