# GTA 6 Zoom API

Czytaj poradniki do GTA VI i pobieraj mapy, lokalizacje, nagrania oraz źródła we wszystkich dostępnych językach.

## Szybki start

1. Otwórz [katalog v1](/api/v1/guias.json?lang=pl) i skopiuj pole `slug` wybranego poradnika.
2. Użyj adresu z pola `markdown`, aby przeczytać pełny artykuł wraz ze źródłami.

```sh
curl 'https://www.gta6zoom.com/api/v1/guias.json?lang=pl'
curl 'https://www.gta6zoom.com/api/v1/articulos/{slug}.md'
```

Zastąp `{slug}` wartością zwróconą przez katalog.

## Punkty końcowe

| Metoda i ścieżka | Odpowiedź |
| --- | --- |
| `GET /api/v1/guias.json?lang=pl` | Katalog JSON z językami, kategoriami i poradnikami. |
| `GET /api/v1/articulos/{slug}.md` | Pełny artykuł w formacie Markdown. |
| `GET /api/v1/agent/sandbox.json?lang=pl` | Katalog tylko do odczytu w uwierzytelnionym środowisku testowym. |

[Specyfikacja OpenAPI](/api/openapi.json) · [Katalog API](/.well-known/api-catalog)

## Uwierzytelnianie i klucze API

Katalog i publiczne artykuły są dostępne anonimowo. Środowisko testowe przyjmuje token Bearer ważny przez dziesięć minut z uprawnieniem `guides:read`. Zobacz [uwierzytelnianie agentów](/pl/auth.md).

## Błędy i wersje

Odpowiedzi o błędach w API v1 zawierają pola `code`, `message` i `hint` w formacie JSON. Nieobsługiwany język zwraca HTTP 400, nieznany identyfikator artykułu HTTP 404, a tymczasowa niedostępność katalogu HTTP 503 z nagłówkiem `Retry-After`.

Główna wersja API jest częścią adresu URL. Zmiany niezgodne z dotychczasową wersją otrzymają nowy numer. O wycofaniu wersji poinformujemy co najmniej 90 dni wcześniej na tej stronie oraz w nagłówkach `Deprecation` i `Sunset`.

## MCP i CLI

- [GTA 6 Zoom MCP](/pl/mcp/) udostępnia poradniki klientom MCP.
- [GTA 6 Zoom CLI](/pl/cli/) pozwala czytać poradniki w terminalu.
- WebMCP rejestruje te same narzędzia w przeglądarkach obsługujących to API.

## A2A

Pobierz [kartę agenta](/.well-known/agent-card.json) i wyślij żądanie JSON-RPC `SendMessage` z tekstem pod podany adres. Wpisz temat lub identyfikator poradnika z katalogu. Pole `metadata.lang` pozwala wybrać język.
