فصل الكتالوج العام عن الاستقبال الخاص
تصف البيانات العامة الخدمة، البلد، السعر والمدة. لا تحتوي على رقم هاتف مخصص أو رمز. التفعيلات تخص حسابًا وطلبًا مع تتبع خاص منفصل.
دليل الخدمة والبلد منفصل عن العروض التجارية. يتطلب عقد التكامل كتالوج API بسعر وتوافر موثوق للطلبات.
الكتالوج والطلب
العقد الحالي يحدد GET /catalog/products و GET /catalog/products/:slug. يوفر الخلفية السعر، المدة والتوافر الصريح؛ يبقى المخزون الغائب مجهولاً.
ترسل الطلبات معرف المنتج مع مفتاح عدم التكرار. يتحقق الخادم من السعر والمخزون قبل الحجز أو التخصيص. قراءة صفحة لا تحفز إجراءات حساسة.
حالات الاستقبال
يميز الوحدة بين التخصيص، الانتظار، الاستلام، الاكتمال، الإلغاء، الانتهاء والفشل. يمكن أن يكون التخصيص معلقًا بدون رقم؛ يتطلب الانتظار الحقيقي والاستلام رقم الخلفية وانتهاء الصلاحية.
كل رسالة لها معرف ثابت، وطابع زمني، ونص. قد يوفر النظام الخلفي رمزًا مستخرجًا؛ يجب ألا يخمن الواجهة رمز التحقق. لا يحتوي الدليل العام على رقم هاتف مخصص أو رمز خاص.
الإجراءات والتحديثات المصرح بها
GET /activations وGET /activations/:id قراءات خاصة. POST /activations/:id/actions يرسل إلغاء، إنهاء أو إعادة إرسال مع مفتاح عدم التكرار. يعلن الواجهة الخلفية ويعيد التحقق من الإجراءات المسموح بها.
القراءات الخاصة تستخدم الجلسة، لغة الواجهة والتخزين المؤقت المناسب. تتبع الفترات يتبع العقد؛ انتهاء صلاحية الخادم والحالة لها أولوية على مؤقت المتصفح.
الدفع، التخصيص وأسرار المزود
تحدد الفاتورة الأصل، الشبكة، المبلغ، العنوان والانتهاء. تأكيد الدفع وتخصيص الرقم أحداث منفصلة. يتعامل النظام الخلفي مع الإخفاقات والمحاولات دون تخصيص مزدوج.
تبقى مفاتيح المزود وأسرار الدفع على الخادم. تفوض API كل قراءة حساب، تحدد احتفاظ الرسائل وتحافظ على معرفات المزود الداخلية خاصة. توثق هذه الصفحة عقد التكامل ولا تعلن عن API عامة تشغيلية.
مرجع نقطة النهاية للعقد
| الطريقة | نقطة النهاية | الدور |
|---|---|---|
GET | /catalog/products | الكتالوج العام |
GET | /activations | تفعيلات الحساب |
GET | /activations/:id | تتبع الاستقبال الخاص |
POST | /activations/:id/actions | إجراء مصرح به |
هذه هي مسارات العقد الأمامية الحالية، وليست نقاط نهاية الإنتاج المنشورة. لا يزال يتعين ربط المزود والمصادقة وتكامل الدفع.