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

> Ejecuta un servidor mock local para probar endpoints de la X API v2 durante el desarrollo sin consumir créditos de la API, además de solicitudes de ejemplo y payloads de respuesta.

El [API Playground](https://github.com/xdevplatform/playground) es un servidor mock local que simula la X API v2 completa. Prueba endpoints, construye prototipos y explora la API sin consumir créditos reales de la API.

<Card title="Repositorio de GitHub" icon="github" href="https://github.com/xdevplatform/playground">
  Código fuente, releases y documentación completa.
</Card>

***

## Funciones

<CardGroup cols={2}>
  <Card title="Compatibilidad total con la API v2" icon="check">
    Todos los endpoints soportados con validación de solicitudes mediante specs de OpenAPI y respuestas de error realistas.
  </Card>

  <Card title="UI web interactiva" icon="browser">
    Explorador visual de endpoints en `http://localhost:8080/playground` para pruebas en el navegador.
  </Card>

  <Card title="No se necesitan créditos" 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">
    Todo se ejecuta localmente con datos mock: no se requieren claves de API ni facturación.
  </Card>

  <Card title="Operaciones con estado" icon="database">
    Estado en memoria con persistencia de archivo opcional. Crea posts y luego consúltalos.
  </Card>
</CardGroup>

***

## Instalación

Requiere Go 1.21+. Instala desde el código fuente o descarga un binario precompilado desde [releases](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="Compilar desde el código fuente">
    ```bash theme={null}
    git clone https://github.com/xdevplatform/playground.git
    cd playground
    go build -o playground ./cmd/playground
    ./playground start
    ```
  </Tab>
</Tabs>

El servidor arranca en `http://localhost:8080` por defecto.

***

## Inicio rápido

Haz solicitudes igual que las harías contra la API real: usa `test_token` como tu bearer token:

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

# Crear un 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"
```

Abre `http://localhost:8080/playground` en tu navegador para la interfaz interactiva.

***

## Qué incluye

| Función                       | Descripción                                                  |
| :---------------------------- | :----------------------------------------------------------- |
| **Validación de solicitudes** | Valida las solicitudes contra la spec de OpenAPI             |
| **Errores realistas**         | Devuelve códigos y mensajes de error apropiados              |
| **Soporte de streaming**      | Endpoints de streaming simulados                             |
| **Rate limiting**             | Simulación configurable de rate limits                       |
| **Soporte de CORS**           | Funciona con aplicaciones basadas en navegador               |
| **Seguimiento de uso**        | Endpoints simulados de facturación y seguimiento de créditos |
| **Persistencia de estado**    | Persistencia opcional en archivo en `~/.playground/`         |

***

## Relacionado

<CardGroup cols={2}>
  <Card title="xurl" icon="terminal" href="/tools/xurl">
    Herramienta CLI para la X API real con autenticación integrada.
  </Card>

  <Card title="Haz tu primera solicitud" 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">
    ¿Listo para la API real? Haz tu primera solicitud.
  </Card>
</CardGroup>