البيئة التجريبية والانتقال إلى التشغيل الفعلي

البيئة التجريبية (sandbox)

شركة اختبار مستقلة، Sandbox Nile Cruises، تشغّل باخرة تجريبية بمواعيد مغادرة تمتد ١٨ شهرًا وأسعار تجريبية. اطلب من فريق ريفرديسك عميل API للبيئة التجريبية. كل شيء يعمل تمامًا كما في شركة حقيقية، بما في ذلك الـ webhooks، ولا يمسّ أي شيء تفعله هناك الحجوزات الحقيقية.

قبل الانتقال إلى التشغيل الفعلي

• تُجدَّد الـ tokens عند 401؛ والأسرار محفوظة على خادمك فقط.
• مفتاح Idempotency-Key واحد لكل إجراء، يُعاد استخدامه عند إعادة المحاولة؛ وchannel_ref محدد في كل تأكيد وكل طلب.
• يُتحقَّق من توقيع كل webhook؛ ويُتجاهَل التكرار بالاعتماد على resource_version.
• يُستخدَم سجل الأحداث للحاق بما فات بعد أي توقف.
• تُعالَج 409 و422 و429 و503 كما في الأخطاء وإعادة المحاولة.
• ينجح المسار الكامل على البيئة التجريبية: عرض السعر ← الحجز المؤقت ← التأكيد ← بيانات الضيوف ← التعديل ← الإلغاء، مع استلام الـ webhooks.

المرجع

الطلب والاستجابة الدقيقان لكل endpoint (نقطة نهاية) موجودان في المرجع التفاعلي على /docs في خادم API، وهو مولَّد من العقد التقني نفسه الذي يُختبر الخادم على أساسه.