---
title: "Fouten en limieten"
description: "Foutcodes, veilig opnieuw proberen en aanvraaglimieten."
---

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

# Fouten en limieten

## Fouten

Elke fout heeft dezelfde vorm:

```json
{
  "error": {
"code": "invalid_input",
"message": "Controleer de velden, waarden en volgorde van de datums.",
"request_id": "c2a1f0e3-4b5d-4c6e-8f7a-9b0c1d2e3f4a"
  }
}
```

De header `X-Request-Id` bevat dezelfde aanvraag-ID. Geef die mee wanneer je WaW contacteert over een mislukte aanvraag.

| Status | Code | Wat je doet |
| --- | --- | --- |
| 400 | `invalid_json` | Stuur een JSON-object met `Content-Type: application/json`. |
| 401 | `invalid_key` | Controleer de sleutel en de omgeving. |
| 403 | `access_revoked` | De koppeling is niet meer actief. Neem contact op met WaW. |
| 403 | `subscription_required` | Het WaW-abonnement of de proefperiode van de klant is afgelopen. |
| 404 | `not_found` | De route bestaat niet, of het record zit niet in het team van deze klant. |
| 405 | `method_not_allowed` | Gebruik POST op de verzameling en PATCH op één record. Zie de header `Allow`. |
| 409 | `reference_conflict` | Deze `external_id` bestaat al met andere gegevens. Gebruik PATCH om hem te wijzigen. |
| 413 | `body_too_large` | Houd de inhoud onder 16 KiB. |
| 422 | `invalid_input` | Controleer veldnamen, waarden, lengtes en de volgorde van de datums. Onbekende velden worden geweigerd. |
| 422 | `invalid_contact` | De `contact_id` zit niet in het team van deze klant. |
| 429 | `rate_limited` | Wacht het aantal seconden uit `Retry-After`. |
| 500 | `internal_error` | Probeer later opnieuw. Blijft het mislukken, stuur WaW dan de aanvraag-ID. |

## Opnieuw proberen

Aanmaken kun je veilig opnieuw proberen. WaW koppelt elke `external_id` aan één record per klantteam.

- Dezelfde aanmaakaanvraag opnieuw geeft `200` met de bestaande ID's. De volgorde van de JSON-sleutels maakt niet uit.
- Een aanmaakaanvraag met dezelfde `external_id` maar andere gegevens geeft `409`. Gebruik dan PATCH.
- Heeft de klant het record verwijderd of naar een ander team verplaatst, dan geeft een nieuwe poging `404`. WaW maakt het niet opnieuw aan.

Ook PATCH-aanvragen kun je veilig herhalen: dezelfde wijziging twee keer sturen geeft hetzelfde resultaat.

## Aanvraaglimieten

Elke klantsleutel staat 60 aanvragen per minuut toe, gedeeld over de vier routes. Het budget start elke minuut opnieuw. Ga je erover, dan krijg je `429` met een header `Retry-After` in seconden.

## Groottelimieten

| Onderdeel | Limiet |
| --- | --- |
| Inhoud van de aanvraag | 16 KiB |
| `external_id` | 128 tekens |
| `name`, `first_name`, `last_name` | 300 tekens |
| `email` | 320 tekens |
| `phone` | 50 tekens |
| `location`, `lost_reason` | 1.000 tekens |

Antwoorden worden nooit gecachet.

Source: https://docs.withoutaworry.com/nl/partners-api/errors-and-limits/index.mdx
