Skip to main content
Suchen

Antworten und Fehlercodes

Was die Anmelde-API zurückgibt und was Ihre Website damit macht.

Nach dem Senden einer Anmeldung erhält Ihre Website eine Antwort mit einem Statuscode.

Die Antworten

Code Bedeutung Was zu tun ist
202 mit einer reference, zum Beispiel "AM-7K3Q9X" Empfangen. Der Antragsteller erhält eine Bestätigungs-E-Mail. Zeigen Sie eine Dankeseite an, gegebenenfalls mit der Referenz.
202 mit "reference": null Empfangen, aber ignoriert (Spam, oder bereits 3 offene Anmeldungen für diese Adresse). Zeigen Sie dieselbe Dankeseite an.
401 Der Schlüssel fehlt, ist unbekannt oder wurde widerrufen. Prüfen Sie die Serverkonfiguration.
413 Die Anmeldung ist zu groß (mehr als 32 KB). Senden Sie weniger Daten mit.
415 Die Anmeldung ist kein JSON. Senden Sie Content-Type: application/json.
422 Ein oder mehrere Felder stimmen nicht. Pro Feld gibt es eine Meldung in der Sprache von locale. Zeigen Sie die Meldungen bei den Feldern an, zum Beispiel company.kvk.
429 Zu viele Anfragen. Versuchen Sie es später erneut.
502 Der Dienst ist vorübergehend nicht verfügbar. Versuchen Sie es später erneut.

Ein Beispiel für eine 422:

{
  "message": "…",
  "errors": { "company.kvk": ["Een KvK-nummer heeft 8 cijfers."] }
}

Gut zu wissen

  • Die Antwort lautet immer „empfangen“, wenn die Daten stimmen. So kann niemand über Ihr Formular herausfinden, ob jemand bereits Kunde ist.
  • Es gibt ein Limit pro Schlüssel und pro Besucher. Laut der technischen Dokumentation sind das 200 Anmeldungen pro Schlüssel pro Stunde und 10 pro IP-Adresse des Besuchers pro Stunde.
War dieser Artikel hilfreich?