Frau am Küchentisch bestellt am Laptop ein Kennzeichen

Für Portale und Shops

Ihre Marke vorn, unsere Schnittstelle dahinter.

Mit der Kennzeichen API binden Portale und Schilder-Shops die Prüfung und Reservierung von Wunschkennzeichen in ihr eigenes Produkt ein — unter eigener Marke, für 399 Zulassungsbezirke.

Selbst registrieren · Freischaltung von Hand · Sandbox-Abfragen kostenlos

BestellungKennzeichen

Beispiel
KennzeichenSchilderKasse

Suche

OL-AB 1*

3 frei
Reservieren · 4,00 €

reserviert

PIN 7F3K92

Ehrlich gesagt

Was Whitelabel hier heißt und was nicht.

Ihr Produkt
customerReference

Das gehört dazu

  • Formular, Gestaltung und Rechnung an Ihre Nutzer
  • Kein Hinweis auf uns in Ihrem Produkt
  • Ihre eigene Kennung je Vorgang (customerReference)
Zulassungsstelle

Reservierungsnachweis

amtlich

Das gehört nicht dazu

  • Der amtliche Reservierungsnachweis stammt von der Zulassungsstelle und nennt deren Vorgang
  • Wir sind kein Zahlungsdienstleister für Ihre Nutzer

Beispiel

Die Antwort, die Ihr Formular anzeigt.

Ist die Kombination frei, liefert die Prüfung das Kennzeichen zurück, so wie Ihr Nutzer es später am Fahrzeug sieht. Mit einem Platzhalter in den Ziffern kommt eine ganze Liste freier Nummern.

Suchmusterks 03403 · uz OL
Oldenburg (Stadt)AVAILABLE

Ist die Kombination frei, liefert die Prüfung das Kennzeichen zurück, so wie Ihr Nutzer es später am Fahrzeug sieht. "outcome": "AVAILABLE"

  • frei
  • frei
  • frei

plates · GET /v1/search?ks=03403&uz=OL&buchstaben=AB&ziffern=1*

Der API-Schlüssel gehört nie in den Browser. Ein Testschlüssel auf der Produktivadresse wird mit 403 abgewiesen.

Ihre Nutzer bleiben in Ihrem Produkt.

Test- und Produktivschlüssel sind getrennt; ein Testschlüssel auf der Produktivadresse wird abgewiesen, statt still etwas anderes zu tun.

Frau im Wohnzimmer, auf ihrem Laptop ist die Startseite von kennzeichenapi.de geöffnet, daneben Fahrzeugschein und Schlüssel

Vorgang am Fahrzeug

Beispiel
status
reserved
reservationCode
7F3K92

per Webhookknz_test_ · knz_live_

Vorher und nachher

Ihr Nutzer sieht nur Sie.

Kein Medienbruch, und jeder Vorgang bleibt bei Ihnen.

Ohne Schnittstelle

3 Schritte · 3 Phasen

In Ihrem Produkt

  1. Ihr Nutzer verlässt Ihr Produkt für das Behördenportal

    01

Im Behördenportal

  1. Ob er zurückkommt, wissen Sie nicht

    02

In Ihrem System

  1. In Ihrem System gibt es keinen Datensatz zur Reservierung

    03

Mit der Kennzeichen API

4 Schritte · 1 Produkt

In Ihrem Produkt
  1. 1

    Ihr Formular, Ihre Gestaltung

    01
  2. 2

    Ihr Backend ruft die Schnittstelle auf — der Schlüssel bleibt serverseitig

    02
  3. 3

    Die Reservierung entsteht als Datensatz in Ihrem System

    03
  4. 4

    Die PIN kommt per Webhook, Sie zeigen sie Ihrem Nutzer

    04

Rechenbeispiel

Ihre Preise, unsere Stückkosten.

300 Reservierungen im Monat, bei zehn Prüfungen je Reservierung — viele Nutzer prüfen, wenige reservieren. Ihren Endkundenpreis legen Sie selbst fest; die Behördengebühr reichen wir unverändert durch.

  • Fehlversuche kosten nichts
  • Behördengebühr ohne Aufschlag
  • Bei 360 von 399 Bezirken erst bei der Zulassung fällig

Behördengebühr nicht enthalten — ohne Aufschlag, bei 360 von 399 Bezirken erst bei der Zulassung fällig.

300
1800

Je Kennzeichen

5,33 €

netto, ohne Behördengebühr

Im Monat

1.599,00 €

Grundgebühr je Kennzeichen: 0,33 €

  • Grundgebühr · fest im Monat99,00 €
  • Prüfungen · 3.000 × 0,10 €300,00 €
  • Reservierungen · 300 × 4,00 €1.200,00 €

Fehlversuche kosten nichts.

Zum Preisrechner →
Der Ablauf

Der Ablauf in drei Schritten.

  1. Schritt 01

    Im eigenen Formular prüfen

    Ihr FormularLive
    wartet
    frei
    vergeben
    Beispiel

    Die Verfügbarkeitsprüfung läuft serverseitig aus Ihrem Backend. Ihre Nutzer sehen Ihr Formular und Ihr Ergebnis, keine fremde Oberfläche.

    POST/v1/search
  2. Schritt 02

    Unter eigener Marke reservieren

    ReservationIhre Marke

    Vorgangsnummer

    RES-4K7Q-2M9X

    Nachweis

    Zulassungsstelle

    Beispiel

    Die Reservierung entsteht auf Ihren Vertrag hin. Der amtliche Nachweis trägt die Zulassungsstelle, nicht uns.

    POST/v1/reservations
  3. Schritt 03

    Getrennte Schlüssel je Umgebung

    Schlüsselgetrennt
    dev.Testknz_test_····
    api.Produktionknz_live_····
    knz_test_ auf api.abgewiesen
    Beispiel

    Test- und Produktivschlüssel sind getrennt; ein Testschlüssel auf der Produktivadresse wird abgewiesen, statt still etwas anderes zu tun.

    knz_test_ · knz_live_

Was Sie davon haben

Konkret für Portale und Shops.

Ihre Marke vorn, unsere Schnittstelle dahinter.

  1. 01 / 04

    Kein Medienbruch für Ihre Nutzer

    Ihre Nutzer sehen Ihr Formular und Ihr Ergebnis, keine fremde Oberfläche.

  2. 02 / 04

    Ein Reservierungsdatensatz in Ihrem eigenen System

    Ihre eigene Kennung je Vorgang (customerReference).

  3. 03 / 04

    Eine Anbindung statt mehrerer Fachverfahren

    Wer es selbst bauen will, baut nicht eine Anbindung, sondern mehrere Fachverfahren nach. Und pflegt sie dann.

  4. 04 / 04

    Getrennte Umgebungen für Test und Produktion

    Test- und Produktivschlüssel sind getrennt; ein Testschlüssel auf der Produktivadresse wird abgewiesen.

Einwände und Fragen

Was vor dem Start gefragt wird.

Antwort nicht dabei? Schreiben Sie uns — wir melden uns in der Regel innerhalb eines Werktags.

Frage stellen

Viele Nutzer prüfen, wenige reservieren. Wird das teuer?

Jede erfolgreiche Prüfung unter 10 Sekunden kostet 0,10 €. Bei zehn berechenbaren Prüfungen je Reservierung sind das 1,00 € zusätzlich zu den 4,00 €. Rechnen Sie im Preisrechner mit Ihrer eigenen Quote.

Wer haftet gegenüber unseren Nutzern?

Sie sind Vertragspartner Ihrer Nutzer, wir Ihrer. Wie wir haften, steht in § 10 unserer AGB.

Sehen unsere Nutzer, dass die Reservierung über einen Dienstleister läuft?

In Ihrem Produkt nicht. Der amtliche Reservierungsnachweis stammt allerdings von der Zulassungsstelle und nennt deren Vorgang — das lässt sich nicht verändern und sollte es auch nicht.

Können wir eigene Preise nehmen?

Ja. Sie rechnen mit Ihren Nutzern ab, wir mit Ihnen. Die Behördengebühr reichen wir unverändert und ohne Aufschlag durch, in exakt der Höhe, in der sie tatsächlich gezahlt wurde.

Wie testen wir, ohne echte Vorgänge auszulösen?

Über die Sandbox mit festen Szenarien. Dieselben Endpunkte, dieselben Felder — aber kein Aufruf erreicht eine Behörde.

Erst in der Sandbox, dann produktiv.

Registrieren Sie sich, wir prüfen von Hand und schalten frei. Die Sandbox kostet nichts und erreicht keine Behörde.

dashboard.kennzeichenapi.deKostenlos registrieren

Führt direkt ins Registrierungsformular. Lieber erst sprechen? Fragen stellen

  • Selbst registrieren
  • Freischaltung von Hand
  • Sandbox-Abfragen kostenlos