إضافة فحص اللوحات: فعّله بنفسك دون انتظار

إلى فحص اللوحات · شاهد التغطية · أمان البيانات لدى زيفرا

كيف تُفعَّل الخدمة؟

كيف أضيف المربع الجاهز؟

يكفي سطر واحد قبل نهاية الصفحة. يعرض المربع خانة الإدخال والنتيجة والبدائل المتاحة ولا يتأثر بتنسيق صفحتك.

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

مفتاح الموقع مرتبط بنطاقك. أما المفتاح السري للربط البرمجي فلا يوضع في صفحة ويب.

مثال: المربع داخل صفحة متجر، اللوحة محجوزة ومعها 3 بدائل متاحة

كيف أنادي الربط البرمجي؟

كل نداء يحتاج الترويسة X-WKZ-Key وفيها مفتاحك. المفتاح يوضع في الترويسة، لا في الرابط ولا في المتصفح.

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
}

وصف الربط البرمجي المقروء آلياً (OpenAPI 3.1)

ما النداءات المتاحة؟

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

ماذا يعني الرد؟

أي الردود تُحتسب؟

كيف أختبر دون تكلفة في بيئة التجربة؟

من حسابك تنشئ مفتاح بيئة التجربة. يبدأ بـ wkz_sbx_ ولا يصل إلى أي جهة ولا يُحتسب. حروف اللوحة تحدد النتيجة.

كيف أحجز عبر الربط البرمجي؟

ترسل اللوحة وبيانات المالك مع الترويسة Idempotency-Key. المفتاح نفسه بالمحتوى نفسه يعيد الطلب نفسه، ولا ينشئ حجزاً ثانياً. يذكر الرد رقم الطلب، وتصل الحالة بالاستعلام أو بالإشعار الآلي.

الحجز الحقيقي قيد الإعداد. في بيئة التجربة يمكن اختبار الخطوات منذ الانطلاق.

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
}

كيف أعرف حالة الحجز؟

من حسابك تحفظ عنواناً يبدأ بـ https. ترسل زيفرا الحدث reservation.updated عند كل تغيّر في الحالة. كل رسالة موقّعة بخوارزمية HMAC-SHA256.

• X-Zevra-Timestamp يذكر وقت الرسالة بالثواني.
• X-Zevra-Signature هو توقيع HMAC-SHA256 على الوقت ثم نقطة ثم المحتوى، بسرّك.
• إذا لم يُجب نظامك بـ 2xx تعيد زيفرا الإرسال بعد 1 و5 و30 و120 و720 دقيقة.

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)

ما الأخطاء التي يبلّغ بها الربط البرمجي؟

ما أزمنة الرد والحدود؟

• زمن رد الفحص، مقيساً خلال 7 أيام و7.020 فحص: النصف أقل من 4,2 ثانية، و75 % أقل من 7,3 ثانية، و95 % أقل من 14,6 ثانية.
• يصل الرد خلال 58 ثانية على الأكثر. اضبط المهلة على 65 ثانية.
• لكل مفتاح 120 طلب في الدقيقة. الفحص بالجملة يُحسب بعدد اللوحات.
• اللوحة المتاحة ليست مخصَّصة. التخصيص يتم عند التسجيل فقط.