Na het versturen van een aanmelding krijgt je website een antwoord met een statuscode.
De antwoorden
| Code | Betekenis | Wat te doen |
|---|---|---|
202 met een reference, bijvoorbeeld "AM-7K3Q9X" |
Ontvangen. De aanvrager krijgt een bevestigingsmail. | Toon een bedankpagina, eventueel met de referentie. |
202 met "reference": null |
Ontvangen maar genegeerd (spam, of al 3 open aanmeldingen voor dit adres). | Toon dezelfde bedankpagina. |
401 |
De sleutel ontbreekt, is onbekend of is ingetrokken. | Controleer de serverconfiguratie. |
413 |
De aanmelding is te groot (meer dan 32 KB). | Stuur minder gegevens mee. |
415 |
De aanmelding is geen JSON. | Stuur Content-Type: application/json. |
422 |
Een of meer velden kloppen niet. Per veld staat er een melding in de taal van locale. |
Toon de meldingen bij de velden, bijvoorbeeld company.kvk. |
429 |
Te veel verzoeken. | Probeer het later opnieuw. |
502 |
De dienst is tijdelijk niet beschikbaar. | Probeer het later opnieuw. |
Een voorbeeld van een 422:
{
"message": "…",
"errors": { "company.kvk": ["Een KvK-nummer heeft 8 cijfers."] }
}
Goed om te weten
- Het antwoord is altijd "ontvangen" als de gegevens kloppen. Zo kan niemand via je formulier uitvinden of iemand al klant is.
- Er is een grens per sleutel en per bezoeker. Volgens de technische documentatie is dat 200 aanmeldingen per sleutel per uur en 10 per IP-adres van de bezoeker per uur.