Testumgebung und Testdaten

Was es gibt

Die Test-Instanz https://api.staging.kfz-api.de mit eigenem Dashboard https://dashboard.staging.kfz-api.de. Sie spricht denselben Vertrag wie die Produktion, hat aber eigene API-Benutzer, Webhooks und Vorgänge. Die Produktversion, mit der sie beim KBA sendet, wird für sie getrennt eingestellt und kann von der der Produktion abweichen; welche es ist, steht auf ihrer eigenen Dokumentationsseite unter Diese Instanz. Davon hängt ab, welche Vorgangsarten sie annimmt.

Die KBA-Testumgebung dahinter. Anträge der Test-Instanz gehen dorthin und werden geprüft und quittiert — aber nicht wirksam. Bescheide schickt sie bisher nicht: Über den Rückkanal kam von dort noch keine 0709, und ein angenommener Antrag bleibt auf weitergeleitet (FORWARDED) stehen. Bescheid, Belege, registrationData und costBreakdown lassen sich dort deshalb nicht durchspielen; wie sie aussehen, zeigen Auskunft, Liste und Belege und Webhooks. Das Dashboard der Test-Instanz zeigt das oben auf jeder Seite als „Testumgebung · nicht wirksam".

Die Testumgebung des Vertrauensdienstes Nect. Zur KBA-Testumgebung passt sie; eine dort unterschriebene Vollmacht ist nicht qualifiziert und damit nur zum Durchspielen des Ablaufs gut. In welcher Nect-Umgebung eine Instanz arbeitet — oder ob überhaupt —, zeigt /health als trustService; die vier möglichen Werte stehen unter Betriebszustand. Ein Vorgang aus der Testumgebung taugt nicht für einen Produktionsantrag (409).

Amtliche Testfahrzeuge für die Außerbetriebsetzung. Das KBA gibt seinem Testzugang Personendatensätze mit FIN, Kennzeichen und Sicherheitscodes bei. Das Dashboard zeigt sie angemeldet unter „Testdaten". Ob das KBA einen Datensatz zu jedem Zeitpunkt in seiner Testumgebung führt, entscheidet das KBA.

PING für Webhooks, von Hand im Dashboard ausgelöst — der Test von Erreichbarkeit und Signaturprüfung, ohne dass ein Antrag nötig ist. Webhooks anlegen und den PING auslösen geht nur im Dashboard; eine Schnittstelle dafür gibt es nicht.

Was es nicht gibt

• Keine amtlichen Testfahrzeuge für die übrigen Vorgangsarten. Für Halteränderung, Umschreibung, Wiederzulassung, Neu- und Tageszulassung liegen bisher keine vor. Wenden Sie sich dafür an den Support — per E-Mail oder Telefon, auch ohne Anmeldung. Diese Dokumentation nennt bewusst keine: Die Fahrzeuge in den Beispielen sind erfunden und dem KBA unbekannt.
• Keine Attrappe des KBA. Die Testumgebung ist eine echte Umgebung des KBA. Sie prüft, ob sie das Fahrzeug kennt, und weist Anträge zu unbekannten Fahrzeugen ab — ein Beispiel dieser Dokumentation, das die Schnittstelle mit 200 annimmt, kann dort trotzdem mit FAILED enden.
• Keine erzwungenen Ergebnisse. Es gibt keinen Schalter, der einen Bescheid, eine Ablehnung oder einen Webhook auf Bestellung erzeugt.
• Keine Webhooks an lokale Adressen. localhost, private Netze und Adressen auf den Server selbst sind als Ziel gesperrt. Nehmen Sie einen von außen erreichbaren Host oder einen Tunnel.
• Keine Kennzeichenreservierung über die Schnittstelle, auch nicht im Test (501).

Nehmen Sie nicht die Papiere eines echten Kunden

Das KBA prüft auch in der Testumgebung, ob es das Fahrzeug kennt. Mit echten Fahrzeugscheinen bekommen Sie dort eine Abweisung und wissen hinterher nicht, ob Ihre Eingabe falsch war oder das Fahrzeug der Testumgebung schlicht unbekannt ist.

Was sich ohne Testfahrzeug prüfen lässt

Alles, was die Schnittstelle vor dem Versand prüft, antwortet sofort — auch ohne ein Fahrzeug, das das KBA kennt:

• Pflichtfelder, Formate und Wertelisten (400 mit Feldname),
• der Ablauf des Vollmachtsvorgangs bis readyForApplication — ein Antrag, der sich auf ihn beruft, lässt sich aber erst nach der Unterschrift durchprüfen; vorher antwortet er mit 409 (siehe Wann Feldfehler sichtbar werden),
• Authentifizierung, Mandantenzuordnung und Fehlerformat,
• Auftragsliste, Vorgangsauskunft und Webhook-Zustellung samt Signatur.

Jedes Beispiel dieser Dokumentation wird in der Testsuite der Schnittstelle abgeschickt — mit nachgebildeter Antwort des KBA — und muss den Status liefern, den die Seite nennt. Ein Beispiel, das Sie abschreiben, besteht also die Prüfung der Schnittstelle vor dem Versand. Was dahinter geprüft wird — ob das KBA das Fahrzeug kennt, ob Nect eine Firma im Handelsregister findet —, ist eine andere Frage.

Wartungsfenster

Zu den festen Wartungszeiten des KBA, in denen Störungen zu erwarten sind, siehe Wartungsfenster des KBA.