# Uwierzytelnianie agentów GTA 6 Zoom

Publiczny katalog i poradniki są dostępne anonimowo. Środowisko testowe pozwala uzyskać krótkotrwały token OAuth z uprawnieniem do odczytu.

## Odnajdź informacje o serwerze

Otwórz [/agent/auth/](/agent/auth/) i przejdź pod adres `resource_metadata` z nagłówka `WWW-Authenticate`. Możesz też zacząć od [metadanych chronionego zasobu](/.well-known/oauth-protected-resource). Sprawdź `authorization_servers`, a następnie pobierz `/.well-known/oauth-authorization-server` od wskazanego wystawcy. Odczytaj pola `agent_auth` i `token_endpoint`.

## Wybierz metodę

Odczytaj `agent_auth.identity_types_supported`. Środowisko testowe umożliwia anonimową rejestrację z uprawnieniem `guides:read`. Logowanie powiązane z kontem za pomocą `identity_assertion` (ID-JAG, `urn:ietf:params:oauth:token-type:id-jag`) i `service_auth` są niedostępne.

## Zarejestruj się

Wyślij `POST` z treścią `{"type":"anonymous"}` i nagłówkiem `Content-Type: application/json` do `identity_endpoint`. Przechowaj zwróconą wartość `identity_assertion` w pamięci do chwili jej wymiany. Wygasa po pięciu minutach.

## Uprawnienie

Pomiń krok `claim`. Rejestracja anonimowa od razu przyznaje `guides:read`. Środowisko testowe nie wiąże go z kontem użytkownika.

## Wymień poświadczenie

Wyślij `POST` do `token_endpoint` w formacie `application/x-www-form-urlencoded`. Jako `grant_type` podaj wartość wskazaną przez wystawcę, a jako `assertion` przekaż zakodowane w URL `identity_assertion`. Jeśli klient używa wskaźnika zasobu, ustaw `resource` na adres środowiska testowego.

## Użyj tokenu `access_token`

Wyślij `GET` do [/api/v1/agent/sandbox.json?lang=pl](/api/v1/agent/sandbox.json?lang=pl) z nagłówkiem `Authorization: Bearer <access_token>`. Odpowiedź zawiera katalog poradników. Token wygasa po 600 sekundach.

## Błędy i wygaśnięcie

Przy błędzie `invalid_grant` zarejestruj się ponownie i wymień nowe poświadczenie. Odpowiedź HTTP 401 zawiera `WWW-Authenticate` i kod błędu w JSON. Przy HTTP 503 skorzystaj z katalogu publicznego. Po zakończeniu usuń token z pamięci. Tokeny wygasają automatycznie i przyznają tylko `guides:read`. Nie ma trwałych zgód delegowanych ani możliwości unieważnienia pojedynczego tokenu.

Dokumentacja protokołu [WorkOS auth.md](https://github.com/workos/auth.md).
