المطوّرون

مبني للخادم الخلفي، ويُتحقَّق منه باستعلام.

المحرّكان واجهتا HTTP برمجيتان مقيّدتان بالمستأجر. بيئتك التجريبية على staging هي المرجع: أنشئها في البوابة، واستدعِ واجهة staging بمفتاح الاختبار الخاص بك.

شكل استدعاء التحقق

GET /v1/bookings/{id}/history
Authorization: Bearer bh_test_…
{
  "chainValid": true,
  "events": [
    { "sequence": 1, "type": "hold.placed",        "eventHash": "a91c…" },
    { "sequence": 2, "type": "booking.confirmed",  "eventHash": "3f9a…" }
  ]
}

شكل توضيحي للطلب والاستجابة؛ الخلاصات عناصر نائبة.

  • المفاتيح والبيئات

    مفتاح واحد لكل مستأجر لكل بيئة. ‏BookingHash: ‏bh_test_ وbh_live_. ‏LedgerHash: ‏lh_test_ وlh_live_. البيئات التجريبية موجودة على staging فقط؛ ومفاتيح الإنتاج لا توجد إلا بعد الانضمام من قائمة الانتظار.

  • كتابات آمنة التكرار

    أرسل ترويسة Idempotency-Key مع كل كتابة إلى BookingHash. إعادة إرسال الطلب نفسه تعيد النتيجة الأصلية.

  • سجل تاريخ BookingHash

    يعيد GET /v1/bookings/{id}/history يوميات الحجز وchainValid. يُعاد حساب السلسلة في قاعدة البيانات مع كل استدعاء.

  • براهين LedgerHash والتحقق

    يعيد GET /v1/verify/entry/{id}/proof مسار تضمين Merkle. ويعيد /v1/verify/* اشتقاق الحمولات ويرجع أول تعارض؛ والنتيجة الفارغة تعني السلامة. ويتحقق GET /v1/verify/anchor/{code} من سجل إرساء.

  • من جهة الخادم فقط

    استدعِ المحرّكين من خادمك. لا تضع مفتاحاً في متصفح أو تطبيق جوّال أبداً.

  • حدود المعدل وإعادة الضبط

    قد تكون البيئات التجريبية محدودة المعدل وقد تُعاد إلى وضعها الأصلي. تعامل مع بيانات staging على أنها قابلة للحذف.

ابدأ ببيئة تجريبية. وانتقل إلى الإنتاج عندما تكون جاهزاً.

سجّل في البوابة، وأنشئ مؤسسة، وافتح بيئة تجريبية. وعندما تحتاج إلى الإنتاج، انضم إلى قائمة الانتظار.

البيئات التجريبية تعمل على بيئة التهيئة (staging) ببيانات اختبار. الوصول إلى الإنتاج يتم عبر قائمة الانتظار.