عندما لا يقدم نظام API عامة، يعتمد التكامل على واجهته المتاحة ولو كانت مصممة للبشر. في منظومة مطاعم DinDin كانت تلك الواجهة صندوق بريد.
01قراءة الأعمال
المشكلة: سوقان دون API للطلبات
تستقبل مطاعم DinDin الطلبات من مواقعها ونقاط بيعها وأسواق التوصيل، ويجب أن تصل جميعها إلى الطابعة والتقارير ومسار العمل نفسه. لم يوفّر Grubhub وDoorDash واجهة الطلبات اللازمة، لكنهما يرسلان تأكيد HTML إلى بريد المطعم.
02قراءة الأعمال
بناء التكامل عبر صندوق البريد
يتصل المسار بصندوق البريد مع المصادقة، ويحلل تأكيد HTML ويطابق التاجر ويحوّل البيانات إلى نموذج طلب DinDin الأصلي، ليصل إلى طابعة المطبخ والتقارير نفسها. توضح أدلة Gmail API، المذكورة أدناه، نمطاً مرجعياً لتكامل البريد الموثق.
03قراءة الأعمال
منع التكرار لضمان أمان إعادة التشغيل
يجب تحمل انقطاع الاتصال أو إعادة معالجة الرسائل. يعتمد منع التكرار على رقم الطلب الأصلي في كل سوق، فلا ينشأ طلب مطبخ ثانٍ عند إعادة المعالجة. يشبه ذلك مبدأ الطلبات الآمنة للتكرار في توثيق Stripe المذكور أدناه.
04قراءة الأعمال
ما الذي يمكن تعميمه؟
عند غياب API، اختر أكثر واجهات النظام استقراراً ولو كانت موجهة للبشر، ثم اجعل إعادة التشغيل آمنة بمنع التكرار. بهذا الانضباط يصبح صندوق البريد واجهة تكامل موثوقة.