تكاملات API مخصصة: حدد عقدًا آمنًا
اتصال API اتفاق تشغيلي بين الأنظمة. ينبغي أن يحدد النظام المالك للسجل، والحدث الذي يرسله، ومن يجوز له قراءته أو تغييره، وكيف يُحل الخلاف. لمدير Datrylo وبيئة Odoo حدود ثقة منفصلة؛ ولا يجوز تخزين بيانات العملاء الخاصة أو بيانات اعتماد المستأجر ذات الامتياز في موقع WordPress العام.
ما المتاح لهذا الاتصال
| الحالة الحالية | نطاق مخصص — لا يوجد موصل جاهز متحقق منه |
|---|---|
| العملية | حدث تجاري متفق عليه وسجله في النظام المستلم |
| حدود التسليم | حدد المرسل ومعرف السجل الخارجي والمستلم والإجراء المسموح. إذا وصل الأمر المؤكد مرتين، أنشئ سجلًا مستلمًا واحدًا؛ وإذا تغيرت كميته، أحل التعارض للمسؤول المحدد. ليست API العامة موصلًا جاهزًا لكل نظام. |
صمم المعاملة الأولى
اختر حدثًا واحدًا مثل طلب مؤكد. حدد الحمولة والمعرف الخارجي الثابت وقواعد التحقق والرد المتوقع. أدرج التسليم المكرر والتأخير وانتهاء المهلة وحقلًا غير صالح. قرر ما إذا كان النظام المستقبِل يعيد المحاولة أو يرفض أو يضع الحدث في قائمة مراجعة. لا يثبت رد HTTP ناجح وحده صحة سجل الأعمال.
أبقِ الصلاحية على الخادم
وثّق كل استدعاء، واقصر بيانات الاعتماد على أقل مورد لازم، ودوّرها. اجعل الكتابة لا تكرر الأثر. احتفظ بسجل تدقيق دون تسجيل الأسرار أو الحمولات الحساسة الكاملة. إذا غيّر التكامل الأسعار أو الاشتراكات أو الأهلية، فيجب أن يعيد النظام الخلفي في Datrylo الحساب وأن يجيز النتيجة.
أثبت دورة الحياة
حدد المرسل ومعرف السجل الخارجي والمستلم والإجراء المسموح. إذا وصل الأمر المؤكد مرتين، أنشئ سجلًا مستلمًا واحدًا؛ وإذا تغيرت كميته، أحل التعارض للمسؤول المحدد. ليست API العامة موصلًا جاهزًا لكل نظام.
مستعد لخطوتك
الكبيرة القادمة؟
اكتشف كيف تبدو الأعمال الأكثر ترابطًا. لنبدأ بمحادثة عن أعمالك.