مرجع الربط البرمجي لفحص اللوحات

فحص اللوحات · إضافة فحص اللوحات · تغطية فحص اللوحات

العنوان الأساسي والمفتاح

السعر كما في الوصف: 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.

نقاط الربط

«بمفتاح» تعني: الترويسة X-WKZ-Key أو Authorization: Bearer. كل رد على نداء بمفتاح يحمل ترويسات الحد.

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

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)

ترويسات الحد

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

نماذج البيانات

أوصاف الحقول منقولة كما هي من ملف OpenAPI وهي بالألمانية.

Error

errorstring · إلزامي

القيم: 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 · إلزامي

–

message_enstring

Dieselbe Meldung auf Englisch

quotaobject

Nur bei quota_exhausted: Stand des Kontingents

Plate

prefixstring · إلزامي

Unterscheidungszeichen, 1 bis 3 Buchstaben

lettersstring · إلزامي

1 bis 2 Buchstaben

numbersstring · إلزامي

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 القيم: 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) القيم: 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 · إلزامي

–

vornamestring

–

geburtsdatumstring

–

strassestring

–

plzstring · إلزامي

–

ortstring · إلزامي

–

Reservation

idstring

–

statusstring

القيم: queued · processing · reserved · failed

environmentstring

القيم: 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 · إلزامي

Unterscheidungszeichen, 1 bis 3 Buchstaben

lettersstring · إلزامي

1 bis 2 Buchstaben

numbersstring · إلزامي

1 bis 4 Ziffern, ohne führende Null

halterHolder · إلزامي

–

customerReferencestring

80 أحرف كحد أقصى

Usage

environmentstring

–

statusstring

–

checksinteger

–

limitinteger

–

reservationsinteger

–

usageCentsinteger

–

authorityFeesAdvancedCentsinteger

–

periodEndstring | null

–

Offices

countinteger

–

officesarray <object>

–

ملفات للتحميل

• وصف الربط البرمجي المقروء آلياً (OpenAPI 3.1)
• تحميل مجموعة Postman (بدون مفتاح، تضيف مفتاحك بنفسك)