> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Přehled chyb

> Všechny chyby, které může veřejné rozhraní API Living Security /v1 vrátit, včetně stabilního strojového kódu, stavu HTTP a postupu řešení.

Každá chybová odpověď `/v1` je `application/problem+json` ([RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)) s pevně stanovenou sadou polí:

```json theme={null}
{
  "type": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No such organization.",
  "code": "resource_not_found",
  "request_id": "req_...",
  "doc_url": "https://docs.livingsecurity.com/developers/v1/errors/resource_not_found",
  "retryable": false
}
```

Větvete logiku podle `code`, nikdy podle `detail` — `code` je stabilní strojový kontrakt, zatímco `detail` je určeno pro člověka a může se změnit. `param` je přítomno, pokud lze chybu přiřadit ke konkrétnímu parametru požadavku. Při kontaktování podpory uveďte `request_id`.

## Kódy chyb

| Kód | Stav HTTP | Lze opakovat |
| - | - | - |
| [`unauthorized`](/cs/developers/v1/errors/unauthorized) | 401 | Ne |
| [`credential_inactive`](/cs/developers/v1/errors/credential_inactive) | 401 | Ne |
| [`credential_expired`](/cs/developers/v1/errors/credential_expired) | 401 | Ne |
| [`credential_revoked`](/cs/developers/v1/errors/credential_revoked) | 401 | Ne |
| [`not_entitled`](/cs/developers/v1/errors/not_entitled) | 403 | Ne |
| [`insufficient_permission`](/cs/developers/v1/errors/insufficient_permission) | 403 | Ne |
| [`permission_denied`](/cs/developers/v1/errors/permission_denied) | 403 | Ne |
| [`resource_not_found`](/cs/developers/v1/errors/resource_not_found) | 404 | Ne |
| [`invalid_request`](/cs/developers/v1/errors/invalid_request) | 400 nebo 409 | Ne |
| [`invalid_filter`](/cs/developers/v1/errors/invalid_filter) | 400 | Ne |
| [`unsupported_version`](/cs/developers/v1/errors/unsupported_version) | 400 | Ne |
| [`idempotency_key_reuse`](/cs/developers/v1/errors/idempotency_key_reuse) | 409 | Závisí na konfliktu |
| [`rate_limited`](/cs/developers/v1/errors/rate_limited) | 429 | Ano |
| [`service_unavailable`](/cs/developers/v1/errors/service_unavailable) | 503 | Ano |
| [`internal_error`](/cs/developers/v1/errors/internal_error) | 500 | Ano |

Sada kódů je uzavřená: nové kódy představují změnu veřejného kontraktu a jsou oznamovány prostřednictvím changelogu API. Odpověď `retryable: true` znamená, že se situace může vyřešit; neprokazuje, že operace zápisu neměla žádný účinek. Operace čtení opakujte s omezeným počtem pokusů a omezeným časovým rozpočtem, s exponenciálním odstupem (backoff) a náhodným rozptylem (jitter). Pokud je přítomna hlavička `Retry-After`, respektujte ji, a to i u opakovatelné odpovědi `409` nebo `429`.

U mutací postupujte podle zdokumentovaného kontraktu dané operace pro idempotenci a obnovu. Pokud je to podporováno, zachovejte původní klíč i původní požadavek. Po vypršení časového limitu nebo po `5xx` nevytvářejte nový klíč: mohlo by dojít k opakování úspěšného zápisu. Hlavička `Idempotency-Key` neposkytuje žádnou ochranu u operace, která ji nepodporuje.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.