# GTA 6 Zoom API

Consulta guías, mapas, ubicaciones, clips y fuentes de GTA VI en los idiomas publicados.

## Inicio rápido

1. Consulta [el catálogo v1](/api/v1/guias.json?lang=es) y elige el `slug` de una guía.
2. Abre el enlace `markdown` de esa guía para leer el artículo completo con sus fuentes.

```sh
curl 'https://www.gta6zoom.com/api/v1/guias.json?lang=es'
curl 'https://www.gta6zoom.com/api/v1/articulos/gta-6-lanzamiento.md'
```

## Endpoints

| Método y ruta | Respuesta |
| --- | --- |
| `GET /api/v1/guias.json?lang=es` | Catálogo JSON con idiomas, categorías y guías. |
| `GET /api/v1/articulos/{slug}.md` | Artículo completo en Markdown. |
| `GET /api/v1/agent/sandbox.json?lang=es` | Catálogo de lectura en el sandbox autenticado. |

[Especificación OpenAPI](/api/openapi.json) · [Catálogo de API](/.well-known/api-catalog)

## Autenticación y claves de API

El catálogo y los artículos públicos admiten acceso anónimo. Para practicar con credenciales, el sandbox acepta un token Bearer de diez minutos con el permiso `guides:read`. El [flujo de autenticación para agentes](/auth.md) explica cómo obtenerlo.

## Errores y versiones

Las respuestas de error de la API v1 incluyen `code`, `message` y `hint` en JSON. Un idioma desconocido devuelve HTTP 400, un slug desconocido devuelve HTTP 404 y una interrupción temporal del catálogo devuelve HTTP 503 con `Retry-After`.

La versión principal va en la URL. Los cambios incompatibles se publican en una nueva versión. Anunciaremos la retirada de una versión con al menos 90 días de antelación en este portal y con las cabeceras HTTP `Deprecation` y `Sunset` en las rutas afectadas.

## MCP y CLI

- [GTA 6 Zoom MCP](/mcp/) para consultar guías desde un cliente MCP.
- [GTA 6 Zoom CLI](/cli/) para consultar guías desde tu terminal.
- WebMCP permite usar las mismas herramientas en navegadores con la API disponible.

## A2A

Descarga la [Agent Card](/.well-known/agent-card.json) y envía al endpoint indicado una solicitud JSON-RPC `SendMessage` con un mensaje de texto. Usa un tema o un slug como `gta-6-lanzamiento`. Puedes pasar `metadata.lang` en los parámetros para consultar otro idioma.
