> ## 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.

# Foutreferentie

> Alle fouten die de openbare API /v1 van Living Security kan retourneren, met de bijbehorende stabiele machinecode, de HTTP-status en de manier om de fout op te lossen.

Elke foutrespons van `/v1` is `application/problem+json` ([RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)) met een vaste set velden:

```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
}
```

Baseer vertakkingslogica op `code`, nooit op `detail`. `code` is een stabiel machinecontract; `detail` is leesbaar voor mensen en kan wijzigen. `param` is aanwezig wanneer de fout te herleiden is tot een specifieke requestparameter. Vermeld `request_id` wanneer u contact opneemt met de support.

## Foutcodes

| Code | HTTP-status | Opnieuw proberen |
| - | - | - |
| [`unauthorized`](/nl/developers/v1/errors/unauthorized) | 401 | Nee |
| [`credential_inactive`](/nl/developers/v1/errors/credential_inactive) | 401 | Nee |
| [`credential_expired`](/nl/developers/v1/errors/credential_expired) | 401 | Nee |
| [`credential_revoked`](/nl/developers/v1/errors/credential_revoked) | 401 | Nee |
| [`not_entitled`](/nl/developers/v1/errors/not_entitled) | 403 | Nee |
| [`insufficient_permission`](/nl/developers/v1/errors/insufficient_permission) | 403 | Nee |
| [`permission_denied`](/nl/developers/v1/errors/permission_denied) | 403 | Nee |
| [`resource_not_found`](/nl/developers/v1/errors/resource_not_found) | 404 | Nee |
| [`invalid_request`](/nl/developers/v1/errors/invalid_request) | 400 of 409 | Nee |
| [`invalid_filter`](/nl/developers/v1/errors/invalid_filter) | 400 | Nee |
| [`unsupported_version`](/nl/developers/v1/errors/unsupported_version) | 400 | Nee |
| [`idempotency_key_reuse`](/nl/developers/v1/errors/idempotency_key_reuse) | 409 | Afhankelijk van het conflict |
| [`rate_limited`](/nl/developers/v1/errors/rate_limited) | 429 | Ja |
| [`service_unavailable`](/nl/developers/v1/errors/service_unavailable) | 503 | Ja |
| [`internal_error`](/nl/developers/v1/errors/internal_error) | 500 | Ja |

De set codes is gesloten: nieuwe codes vormen een wijziging van het openbare contract en worden aangekondigd via de API-changelog. Een `retryable: true`-respons betekent dat de situatie zich mogelijk vanzelf oplost; het bewijst niet dat een schrijfactie geen effect heeft gehad. Probeer leesverzoeken opnieuw met een beperkt aantal pogingen en een beperkt tijdsbudget, met exponentiële backoff en jitter. Houd rekening met `Retry-After` wanneer dit aanwezig is, ook bij een opnieuw te proberen `409` of `429`.

Volg voor mutaties het gedocumenteerde idempotentie- en herstelcontract van de bewerking. Behoud de oorspronkelijke sleutel en het oorspronkelijke verzoek wanneer dat wordt ondersteund. Genereer na een timeout of `5xx` geen nieuwe sleutel: daardoor kan een geslaagde schrijfactie worden herhaald. Een `Idempotency-Key`-header biedt geen bescherming bij een bewerking die dit niet ondersteunt.


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