Kennzeichen-Check einbinden: selbst aktivieren, ohne Rückfrage

Zum Kennzeichen-Check · Abdeckung ansehen · Datensicherheit bei Zevra

Wie wird der Kennzeichen-Check aktiviert?

Wie binde ich das Widget ein?

Eine Zeile vor dem schließenden body-Element genügt. Das Widget zeigt Eingabefeld, Ergebnis und freie Alternativen und übernimmt keine Stile Ihrer Seite.

<script src="https://zevra24.de/kc.js"
  data-site-key="IHR_SITE_SCHLUESSEL"
  data-prefix="RE"
  async></script>

Der Site-Schlüssel ist an Ihre Domain gebunden. Der geheime Schlüssel der Schnittstelle gehört nicht in eine Webseite.

Beispiel: Widget in einer Händlerseite, Kombination vergeben mit 3 freien Alternativen

Wie rufe ich die Schnittstelle auf?

Jeder Aufruf braucht den Kopf X-WKZ-Key mit Ihrem Schlüssel. Der Schlüssel gehört in den Kopf, nie in die URL und nie in den Browser.

curl "https://app.zevra24.de/api/kc/v1/search?prefix=RE&letters=AB&numbers=123" \
  -H "X-WKZ-Key: IHR_SCHLUESSEL"

{
 "plate": "RE-AB 123",
 "available": true,
 "reason": "checked",
 "latency_ms": 3771
}

Maschinenlesbare Beschreibung der Schnittstelle (OpenAPI 3.1)

Welche Aufrufe gibt es?

curl -X POST https://app.zevra24.de/api/kc/v1/search/batch \
  -H "X-WKZ-Key: IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"prefix":"RE","letters":"AB","numbers":"123"},{"prefix":"RE","letters":"AB","numbers":"124"}]}'

Was bedeutet die Antwort?

Welche Antworten werden gezählt?

Wie teste ich ohne Kosten in der Sandbox?

Im Kundenbereich erzeugen Sie einen Sandbox-Schlüssel. Er beginnt mit wkz_sbx_, erreicht keine Behörde und wird nicht berechnet. Die Buchstaben der Kombination bestimmen das Ergebnis.

Wie reserviere ich über die Schnittstelle?

Sie senden Kombination und Halterdaten mit dem Kopf Idempotency-Key. Derselbe Schlüssel mit demselben Inhalt liefert denselben Vorgang, nie eine zweite Reservierung. Die Antwort nennt den Vorgang, der Status folgt per Abfrage oder Webhook.

Die echte Reservierung ist in Vorbereitung. In der Sandbox ist der Ablauf zum Start testbar.

curl -X POST https://app.zevra24.de/api/kc/v1/reservations \
  -H "X-WKZ-Key: wkz_sbx_IHR_SANDBOX_SCHLUESSEL" \
  -H "Idempotency-Key: auftrag-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{"prefix":"RE","letters":"OK","numbers":"123","customerReference":"Auftrag 0001",
       "halter":{"name":"Mustermann","vorname":"Max","plz":"45657","ort":"Recklinghausen"}}'

{
 "id": "RES-7F3K2M9Q",
 "status": "queued",
 "environment": "sandbox",
 "plate": "RE-OK 123",
 "customerReference": "Auftrag 0001",
 "reservationCode": null,
 "authorityFeeAdvancedCents": 0
}

Wie erfahre ich den Status einer Reservierung?

Im Kundenbereich hinterlegen Sie eine https-Adresse. Zevra sendet bei jedem Statuswechsel das Ereignis reservation.updated. Jede Nachricht ist mit HMAC-SHA256 signiert.

• X-Zevra-Timestamp nennt den Zeitpunkt der Nachricht in Sekunden.
• X-Zevra-Signature ist HMAC-SHA256 über Zeitstempel, Punkt und Inhalt, mit Ihrem Secret.
• Antwortet Ihr System nicht mit 2xx, wiederholt Zevra die Zustellung nach 1, 5, 30, 120 und 720 Minuten.

import hmac, hashlib

def echt(secret, timestamp, body, signature):
    soll = hmac.new(secret.encode(), f"{timestamp}.{body}".encode(), hashlib.sha256).hexdigest()
    return hmac.compare_digest(soll, signature)

Welche Fehler meldet die Schnittstelle?

Welche Antwortzeiten und Grenzen gelten?

• Antwortzeit einer Prüfung, gemessen über 7 Tage und 7.020 Prüfungen: die Hälfte unter 4,2 Sekunden, 75 % unter 7,3 Sekunden, 95 % unter 14,6 Sekunden.
• Spätestens nach 58 Sekunden kommt eine Antwort. Bitte Zeitlimit auf 65 Sekunden stellen.
• Je Schlüssel sind 120 Anfragen pro Minute möglich. Eine Sammelabfrage zählt je Kombination.
• Ein freies Kennzeichen ist keine Zuteilung. Zugeteilt wird erst bei der Zulassung.