Błędy

Błędy mają format Problem Details (RFC 9457) z Content-Type: application/problem+json:

{
  "type": "https://httpstatuses.com/409",
  "title": "Conflict",
  "status": 409,
  "detail": "Account is managed by another source.",
  "code": "managed_elsewhere"
}

Opieraj się na status i — jeśli jest — kodzie maszynowym (code albo kod na początku detail, np. WEBHOOK_HOST_NOT_ALLOWED). detail jest dla ludzi i może się zmieniać.

Status	Znaczenie	Co zrobić
`400`	Błędne żądanie albo `TENANT_CODE_REQUIRED` — brak nagłówka `X-Tenant-Code`.	Popraw żądanie.
`401`	Brak, błędne lub wygasłe dane dostępowe (bez podania przyczyny).	Sprawdź z administratorem IT sekret, stan klienta i listę adresów IP.
`403`	Brak zakresu, host docelowy spoza listy klienta albo organizacja zawieszona (`TENANT_SUSPENDED`).	Zwróć się do administratora IT.
`404`	Nie znaleziono zasobu albo `TENANT_NOT_FOUND` — nieznany kod organizacji dla tego adresu API.	Sprawdź identyfikatory i kod organizacji.
`409`	Konflikt: duplikat, `MANAGED_ELSEWHERE`, równoczesna zmiana.	Wyszukaj zasób; nie ponawiaj na ślepo.
`422`	Walidacja nie powiodła się; `errors` mapuje pola na komunikaty.	Popraw wskazane pola.
`429`	Limit żądań — zobacz limity.	Odczekaj `Retry-After` sekund.
`5xx`	Chwilowy problem po naszej stronie.	Ponów z odstępem.

Punkt wydawania tokenów OAuth zwraca błędy OAuth ({"error": "invalid_client"}) zamiast Problem Details, a serwer SCIM — błędy SCIM (urn:ietf:params:scim:api:messages:2.0:Error).