Fouten
Elke fout heeft dezelfde vorm:
{
"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
200met de bestaande ID’s. De volgorde van de JSON-sleutels maakt niet uit. - Een aanmaakaanvraag met dezelfde
external_idmaar andere gegevens geeft409. 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.
