Plaka sorgusu API referansı

Plaka sorgusu · Plaka sorgusunu entegre edin · Plaka sorgusu kapsamı

Temel adres ve anahtar

Tanımdaki fiyat: Wunschkennzeichen live prüfen und reservieren. Grundgebühr 50,00 € im Monat, 0,05 € je berechneter Prüfung, 2,00 € je erfolgreicher Reservierung (netto, zuzüglich Behördengebühren). Limit: 120 Anfragen pro Minute je Schlüssel. Schlüssel mit wkz_sbx_ sind Sandbox-Schlüssel: feste Szenarien, keine Behörde, keine Berechnung.

Uç noktalar

Anahtarlı demek: X-WKZ-Key başlığı veya Authorization: Bearer. Anahtarlı her yanıt sınır başlıklarını taşır.

• GETVerfügbarkeit einer Kombination prüfen (anahtarlı)
• POSTVerfügbarkeit aus dem domaingebundenen Widget prüfen (anahtarsız)
• POSTÖffentliche Zevra-Testabfrage, 10 Versuche pro Besucher und Tag (anahtarsız)
• POSTBis zu 50 Kombinationen in einem Aufruf prüfen (anahtarlı)
• POSTReservierung anlegen (nur mit aktivem Abonnement oder Sandbox-Schlüssel) (anahtarlı)
• GETStatus einer Reservierung (anahtarlı)
• GETVerbrauch und Kosten des laufenden Zeitraums (anahtarlı)
• GETZulassungsstellen und Zustand, optional nach Kürzel gefiltert (ohne Schlüssel) (anahtarsız)
• GETFeste Szenarien der Sandbox (ohne Schlüssel) (anahtarsız)
• GETDiese Beschreibung (anahtarsız)
• GETDiese Beschreibung als Postman-Sammlung (ohne Schlüssel) (anahtarsız)

GET https://app.zevra24.de/api/kc/v1/search

POST https://app.zevra24.de/api/kc/v1/widget/search

POST https://app.zevra24.de/api/kc/v1/public/search

POST https://app.zevra24.de/api/kc/v1/search/batch

POST https://app.zevra24.de/api/kc/v1/reservations

GET https://app.zevra24.de/api/kc/v1/reservations/{rid}

GET https://app.zevra24.de/api/kc/v1/usage

GET https://app.zevra24.de/api/kc/v1/offices

GET https://app.zevra24.de/api/kc/v1/sandbox/scenarios

GET https://app.zevra24.de/api/kc/v1/openapi.json

GET https://app.zevra24.de/api/kc/v1/postman.json

Webhook

Sınır başlıkları

X-RateLimit-Limitinteger

Anfragen pro Minute je Schlüssel

X-RateLimit-Remaininginteger

Verbleibende Anfragen in der laufenden Minute

X-RateLimit-Resetinteger

Sekunden bis zur nächsten Minute

Retry-Afterinteger

Nur bei zu vielen Anfragen pro Minute: Sekunden bis zum nächsten Versuch

Veri modelleri

Alan açıklamaları OpenAPI dosyasından değiştirilmeden alınmıştır ve Almancadır.

Error

errorstring · zorunlu

Değerler: backend · bad_request · batch_size · holder · idem_conflict · idem_key · letters · no_backend · not_found · numbers · prefix · quota_exhausted · rate_limited · revoked · subscription_required · unauthorized

messagestring · zorunlu

–

message_enstring

Dieselbe Meldung auf Englisch

quotaobject

Nur bei quota_exhausted: Stand des Kontingents

Plate

prefixstring · zorunlu

Unterscheidungszeichen, 1 bis 3 Buchstaben

lettersstring · zorunlu

1 bis 2 Buchstaben

numbersstring · zorunlu

1 bis 4 Ziffern, ohne führende Null

SearchResult

platestring | null

–

availableboolean | null

true = frei · false = vergeben · null = keine Aussage (nie als vergeben anzeigen)

reasonstring

Ohne Aussage (available = null): office_not_queryable/gate = Stelle nicht online prüfbar · check_failed/captcha_expired = Stelle antwortet gerade nicht, später erneut · unknown_prefix/unknown_office = Kürzel unbekannt · ambiguous_prefix = mehrere Stellen, plz oder office_id angeben. quota_exhausted · revoked · rate_limited · no_backend nur in /search/batch: ab diesem Eintrag wurde nicht mehr geprüft Değerler: checked · checked_via_twin · checked_via_warm_session · checked_via_captcha · check_failed · captcha_expired · gate · office_not_queryable · ambiguous_prefix · unknown_prefix · unknown_office · invalid · quota_exhausted · revoked · rate_limited · no_backend

sandboxboolean

–

known_officeboolean

Das Kürzel gehört zu einer bekannten Zulassungsstelle

checkableboolean

Die Zulassungsstelle ist live abfragbar

latency_msinteger

Antwortzeit der Behörde in Millisekunden

plate_invalidstring

Gesetzt, wenn die Kombination formal unzulässig ist (keine Prüfung gezählt) Değerler: prefix · letters · numbers · office

remaining_todayinteger

Nur /public/search: verbleibende Testabfragen heute

suggestionsarray <object>

Nur /public/search bei vergebenem Kennzeichen: freie Alternativen

suggestions_limitedboolean

Nur /public/search: die Behörde nannte weniger Alternativen als angefragt

suggestions_unavailableboolean

Nur /public/search: Alternativen konnten gerade nicht abgefragt werden

Holder

namestring · zorunlu

–

vornamestring

–

geburtsdatumstring

–

strassestring

–

plzstring · zorunlu

–

ortstring · zorunlu

–

Reservation

idstring

–

statusstring

Değerler: queued · processing · reserved · failed

environmentstring

Değerler: live · sandbox

platestring

–

customerReferencestring | null

–

reasonstring | null

–

reservationCodestring | null

Code der Behörde für die Zulassung, nur bei status=reserved

authorityFeeAdvancedCentsinteger

Von Zevra verauslagte Behördengebühr in Cent (durchlaufender Posten)

createdAtstring

–

updatedAtstring

–

BatchResult

countinteger

–

resultsarray <SearchResult>

–

ReservationRequest

prefixstring · zorunlu

Unterscheidungszeichen, 1 bis 3 Buchstaben

lettersstring · zorunlu

1 bis 2 Buchstaben

numbersstring · zorunlu

1 bis 4 Ziffern, ohne führende Null

halterHolder · zorunlu

–

customerReferencestring

en fazla 80 karakter

Usage

environmentstring

–

statusstring

–

checksinteger

–

limitinteger

–

reservationsinteger

–

usageCentsinteger

–

authorityFeesAdvancedCentsinteger

–

periodEndstring | null

–

Offices

countinteger

–

officesarray <object>

–

İndirilebilir dosyalar

• API'nin makine tarafından okunabilir tanımı (OpenAPI 3.1)
• Postman koleksiyonunu indirin (anahtar içermez, kendinizinkini eklersiniz)