Plaka sorgusunu entegre edin: kendiniz etkinleştirin, beklemeden

Plaka sorgusuna git · Kapsamı görün · Zevra'da veri güvenliği

Plaka sorgusu nasıl etkinleştirilir?

Widget'ı nasıl eklerim?

Sayfanın sonuna tek satır yeterlidir. Widget giriş alanını, sonucu ve boş alternatifleri gösterir ve sayfanızın stillerinden etkilenmez.

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

Site anahtarı alan adınıza bağlıdır. Gizli API anahtarı bir web sayfasına konulmaz.

Örnek: bir satıcı sayfasında widget, kombinasyon dolu ve 3 boş alternatif

API'yi nasıl çağırırım?

Her çağrıda anahtarınızı içeren X-WKZ-Key başlığı gerekir. Anahtar başlıkta olmalı; URL'de veya tarayıcıda değil.

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
}

API'nin makine tarafından okunabilir tanımı (OpenAPI 3.1)

Hangi çağrılar var?

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"}]}'

Yanıt ne anlama gelir?

Hangi yanıtlar sayılır?

Sandbox'ta ücretsiz nasıl test ederim?

Müşteri alanında bir sandbox anahtarı oluşturursunuz. wkz_sbx_ ile başlar, hiçbir kuruma ulaşmaz ve ücretlendirilmez. Sonucu kombinasyonun harfleri belirler.

API üzerinden nasıl rezervasyon yaparım?

Kombinasyonu ve araç sahibinin bilgilerini Idempotency-Key başlığıyla gönderirsiniz. Aynı anahtar aynı içerikle aynı işlemi döndürür, ikinci bir rezervasyon oluşturmaz. Yanıt işlemi bildirir; durum sorguyla veya webhook ile gelir.

Gerçek rezervasyon hazırlanıyor. Sandbox'ta akış başlangıçtan itibaren test edilebilir.

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
}

Rezervasyonun durumunu nasıl öğrenirim?

Müşteri alanında bir https adresi kaydedersiniz. Zevra her durum değişikliğinde reservation.updated olayını gönderir. Her mesaj HMAC-SHA256 ile imzalanır.

• X-Zevra-Timestamp, mesajın zamanını saniye olarak bildirir.
• X-Zevra-Signature; zaman damgası, nokta ve içerik üzerinden, sizin anahtarınızla HMAC-SHA256 imzasıdır.
• Sisteminiz 2xx ile yanıt vermezse Zevra gönderimi 1, 5, 30, 120 ve 720 dakika sonra tekrarlar.

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)

API hangi hataları bildirir?

Hangi yanıt süreleri ve sınırlar geçerli?

• Bir sorgunun yanıt süresi, 7 gün ve 7.020 sorgu üzerinden ölçüldü: yarısı 4,2 saniyenin, %75'i 7,3 saniyenin, %95'i 14,6 saniyenin altında.
• Yanıt en geç 58 saniyede gelir. Zaman aşımını 65 saniyeye ayarlayın.
• Her anahtar dakikada 120 isteğe izin verir. Toplu sorgu kombinasyon başına sayılır.
• Boş plaka tahsis değildir. Tahsis ancak tescil sırasında yapılır.