Naar de inhoud

Fouten en limieten

Foutcodes, veilig opnieuw proberen en aanvraaglimieten.

Updated Bekijk als markdown

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

Navigatie

Type to search…

↑↓ navigate↵ selectEsc close