مقدمة
تتيح واجهة تكامل أوكتين لنظام تخطيط الموارد أو إدارة الأسطول أو المحاسبة لديك سحب معاملات الوقود المؤكدة واستقبالها كـ webhooks موقّعة. ابدأ من هنا.
تمنح واجهة تكامل أوكتين أنظمتك وصولًا موثوقًا وشبه فوري إلى بيانات معاملات الوقود الخاصة بك. صُممت لتكاملات تخطيط الموارد وإدارة الأساطيل والمحاسبة، وهي متاحة لعملاء أوكتين عند الطلب.
طريقتان للحصول على بياناتك
واجهة السحب (Pull API)
نقطة نهاية REST تعيد معاملاتك المؤكدة والخارجية، مع تصفية حسب نطاق التاريخ ومجموعة الشركات والشركة والحالة، وترقيم صفحات بالمؤشر.
الويب هوك (Push)
تستدعي أوكتين عنوانًا تحدده أنت كلما تم تأكيد إحدى معاملاتك أو تسجيل معاملة خارجية. كل تسليم موقّع بـ HMAC-SHA256.
تعيد الطريقتان سجل المعاملة نفسه، لذا يمكنك البدء بواجهة السحب وإضافة الويب هوك لاحقًا دون تغيير نموذج بياناتك.
كيف يعمل الوصول
| المصادقة | مفتاح API ثابت طويل الأمد يُرسل في ترويسة X-API-Key. لا تسجيل دخول ولا تجديد رموز. |
| النطاق | ينتمي المفتاح إلى حساب عميل واحد ويغطي كل مجموعات الشركات والشركات التابعة له. |
| الشبكة | مفاتيح الإنتاج مقيّدة بقائمة عناوين IP المسموح بها، وكل مفتاح محدود بـ 60 طلبًا في الدقيقة. |
| البيانات | لا تُعاد أو تُرسل سوى المعاملات بحالة CONFIRMED وEXTERNAL. |
تُصدر أوكتين المفاتيح وتديرها. للبدء، اطلب من مدير حسابك في أوكتين تفعيل التكامل على حسابك. راجع دليل البداية السريعة لقائمة الإعداد الكاملة.
ما لا تشمله الواجهة
- إدارة المفاتيح ذاتيًا: تُنشأ المفاتيح وتُفعَّل وتُعطَّل من جانب أوكتين.
- إشعارات بتغيّرات الحالة اللاحقة (مثل إلغاء معاملة بعد تأكيدها). راجع اكتشاف المعاملات الملغاة.
- مفاتيح مقيّدة بمجموعة شركات أو شركة واحدة. المفتاح يغطي حساب العميل بالكامل دائمًا.