البيئات
عنوان الإنتاج الأساسي هو https://prod-app.octanetech-api.com/api/v1/integration. تبدأ مفاتيح الاختبار بـ oct_test_ ولا تعمل إلا في بيئة الاختبار.
يوجد عنوان أساسي واحد للإنتاج، https://prod-app.octanetech-api.com/api/v1/integration. أما مضيف بيئة الاختبار ومفتاح الاختبار فيقدمهما مدير حسابك في أوكتين أثناء الإعداد. يعمل المفتاح فقط في البيئة التي أُصدر لها.
العناوين الأساسية
| البيئة | العنوان الأساسي | بادئة المفتاح |
|---|---|---|
| الإنتاج | https://prod-app.octanetech-api.com/api/v1/integration | oct_live_ |
| الاختبار | يقدمه مدير حسابك في أوكتين أثناء الإعداد | oct_test_ |
كل مسارات واجهة السحب في هذه الوثائق نسبية للعنوان الأساسي. مثلًا، نقطة نهاية المعاملات هي:
GET https://prod-app.octanetech-api.com/api/v1/integration/transactionsالفروق بين البيئتين
| الإنتاج | الاختبار | |
|---|---|---|
| قائمة IP المسموح بها | مطلوبة لكل مفتاح | غير مطلوبة؛ تقبل مفاتيح الاختبار أي عنوان مصدر |
| حد المعدل | 60 طلبًا في الدقيقة لكل مفتاح | 60 طلبًا في الدقيقة لكل مفتاح |
| البيانات | معاملاتك الحقيقية | بيانات اختبار |
| الويب هوك | تُسلَّم إلى عنوان الإنتاج لديك | تُسلَّم إلى العنوان المضبوط على مفتاح الاختبار |
لا تُصدر مفاتيح الاختبار إلا لبيئة الاختبار وتُرفض في الإنتاج. اطلب من مدير حسابك مفتاح اختبار إذا أردت البناء على بيانات اختبار قبل الإطلاق.
إصدار الواجهة
تحمل حمولات الويب هوك حقل api_version (حاليًا 2026-09-01). شكل استجابة واجهة السحب وكائن data.transaction في الويب هوك بالإصدار نفسه. سيُعلن عن أي تغييرات غير متوافقة في سجل التغييرات قبل إطلاقها.
قد تُضاف حقول جديدة إلى الاستجابات والحمولات في أي وقت دون تغيير الإصدار. ابنِ المحلّل لديك ليتجاهل الحقول غير المعروفة.
النقل
- HTTPS فقط. لا يُقدَّم HTTP العادي.
- الاستجابات بصيغة JSON بترميز UTF-8 مع
Content-Type: application/json. - كل الطوابع الزمنية بصيغة ISO 8601 بالتوقيت العالمي (اللاحقة
Z).