ربط الواجهات
تكامل API: حمولة مسمّاة بين نظامين.
تستلمون وصلاً يعمل بين نظامين تستخدمونهما. ينتقل رقم أو طلب أو دفعة من أحدهما إلى الآخر، ويمكنكم رؤية ما يحدث حين لا يجيب الطرف الآخر. الرسم في هذه الصفحة مثال لذلك الوصل. وهو لا يربط كل واجهة على الإنترنت.
- الرسم عيّنة لا نداء حي
- لا يُطبع سر على الصفحة
- تُكتب قاعدة الفشل قبل أول تشغيل
عيّنة
العميل
متجر نورث يارد
الواجهة
الأنبوب المسمّى
الخادم
الدفاتر
طلب
جواب
قبل النداء الأول
ستة أمور يجب أن يستطيع الربط قولها
شعار على شريحة ليس وصلة. إن بقي أي سطر أدناه «سنرى» فالأنبوب غير جاهز. يسمّيها عرض السعر. وقائمة الإضافات لا تفعل.
الطرفان
النظام الذي يسأل والنظام الذي يجيب. يُسمّى الاثنان بما في ذلك الذي تدفعون له. و«الإنترنت» ليس طرفاً.
الحمولة
الحقول التي تسافر. رقم فاتورة أو حالة أو اسم. لا «سجل العميل» كإحساس. إن نقص حقل فالنداء شكل خاطئ.
الاتجاه
اتجاه واحد أو الاثنان. قد يسأل المتجر الدفاتر عن حالة. وقد تحتاج الدفاتر أن تسمع أن المتجر أخذ طلباً. هذان نداءان حتى حين يقول الناس «الربط».
كم مرة
حين ينقر شخص أو على ساعة أو حين يدفع الطرف الآخر. «الوقت الحقيقي» عبارة. والموجز يقول اللحظة الفعلية.
الفشل
إعادة أو توقف أو عرض آخر جواب صالح. وعلامة خضراء والطرف الآخر متوقف كذبة. تُختار القاعدة قبل أول تشغيل لا بعد أول صباح غاضب.
سجل التشغيل
يكفي لرؤية أن النداء غادر وماذا عاد أو أنه لم يعد. قابل للتصدير. ليس سجلاً سرياً داخل بائع لا يمكنكم تركه.
نداء واحد مكتوب
طلب عيّنة والجواب الذي يتوقعه
لدى نورث يارد أصلاً شاشة متجر. ولدى الدفاتر أصلاً الفاتورة. وما زال أحدهم ينسخ NY-1042 من واحد إلى الآخر. القسيمة أدناه شكل تلك النسخة. ليست وصلة نشغّلها و NY-1042 ليست فاتورة حقيقية.
نداء عيّنة
ليس حياً- يسأل
- متجر نورث يارد
- يحمل
- رقم الفاتورة NY-1042
- يجيب
- الدفاتر
- المتوقع
- محجوز ولم يُشحن
أين يعيش الأنبوب
ثلاث طرق لوجود الوصلة. البناء واحدة منها.
بعض الأعمال تدفع أصلاً لموصل بين هذين النظامين. وبعضها يحتاج حقلاً لا يحمله الموصل. وبعضها يحتاج بناء الأنبوب لأن أياً من الطرفين لن يتكلم إلا إذا كتب أحد النداء. الملاحظة الأولى تقول أيها.
-
٠١
أبقوا الموصل
تدفعون أصلاً لوصل بين هذين. قد يكون الموجز الحقل الذي يسقطه أو الفشل الذي يخفيه. وأنبوب جديد ينسخ طريقاً لديكم.
-
٠٢
حقل واحد ناقص
الموصل يعمل. والحالة التي يحتاجها الناس ليست عليه. العمل هو ذلك الحقل واسمه في كل طرف وماذا يُعرض حين يكون فارغاً.
-
٠٣
ابنوا الأنبوب
ليس لدى أي طرف وصل يمكن الوثوق به. حينها النداء هو المنتج. ويسمّي عرض السعر الحمولة والاتجاه والفشل وأين يعيش السر.
نطاق إرشادي
ثلاثة موجزات للربط. عرض السعر هو الثمن الوحيد.
سعر عام يتجاهل أي نظامين تدفعون لهما وهل الحقل الواحد هو العمل كله. هذه الأشكال تساعد على الموجز. وليست قائمة تراخيص واجهات.
نداء واحد
حمولة واحدة واتجاه واحد
نظام يسأل. ونظام يجيب. وقاعدة الفشل داخلة لأن نداء بلاها عرض.
ابدأوا بنداء واحدالأنبوب
الموجز المعتاد
الاتجاهان حين يحتاج العمل إليهما والحقول في كل طرف والفشل وسجل التشغيل. وتبقى الأسرار حيث يقول عرض السعر.
اطلبوا هذا النطاقالأنبوب والساعة
بعد أن يصبح النداء الأول حقيقياً
جدول أو دفع من الطرف الآخر يُضاف بعد أن يعيد النداء الأول جواباً حقيقياً. يُسعَّر حينها لا قبل ذلك.
اطلبوا هذا النطاققبل تسمية النداء
أسئلة تغيّر الحمولة إذا تغيّر الجواب
هل ستربطون أي واجهة نسمّيها؟
لا. يسمّي عرض السعر النظامين والحمولة. إن لم يكن لدى الطرف الآخر طريق موثّق للدخول أو لا يحمل الطريق الحقل الذي تحتاجونه نقوله قبل البناء. وقائمة شعارات ليست نطاقاً.
هل الربط هو الأتمتة نفسها؟
لا. الأتمتة خطوة يكررها شخص بين أدوات تستخدمونها. والربط هو الحمولة التي يتبادلها النظامان بما في ذلك الفشل. قد تحتاجون الاثنين. والملاحظة الأولى تقول أيهما العمل.
هل تطبعون مفتاح النظام الآخر على صفحة؟
لا. يبقى المفتاح أو الرمز أو كلمة المرور في المكان الذي يسمّيه عرض السعر. ولا يُكتب في صفحة يفتحها عميل ولا يُلصق في محادثة كطريقة «لتشغيله فحسب». الاستوديو في الهند. والسوق الأساسي الإمارات والخليج.
ماذا إن كان الطرف الآخر متوقفاً؟
تعمل قاعدة الفشل. إعادة أو توقف أو عرض آخر جواب صالح. ولا تعرض الشاشة نجاحاً لنداء لم يعد. وهذا الخيار في عرض السعر لأن صباح الليلة الفائتة هو حين يلاحظ الناس أن النظامين لم يعودا متطابقين.
هل يجب أن يكون هذا ووردبريس؟
لا. ووردبريس طرف محتمل حين يكون الموجز موقع ووردبريس. ولا نبدأ من دليل إضافات. هذا الموقع PHP و MySQL و HTML. وقد يستخدم مشروع العميل حزمة أخرى حين يقول عرض السعر إن الحمولة تحتاجها.
هل يمكن أن تكون الشاشة حول النداء بالعربية أو الهندية؟
نعم عندما يطلب الموجز. يمكن أن تبقى الحمولة بلغة النظام الآخر. ويمكن أن تكون الشاشة التي يقرأها شخص بالإنجليزية والعربية من اليمين والهندية. وتُفحص هذه التسميات قبل أول نداء حقيقي.
أحضروا النظامين لا صفحة شعارات
ما يسأل وما يجيب وأي حقل يجب أن ينجو من الرحلة يكفي للبدء. تحصلون على ملاحظة مكتوبة: هذا النداء وهذا الفشل وهذا مكان السر — أو توصية بإبقاء الموصل الذي تدفعون له.