توصيل أي شيء
HTTP داخليًا، وHTTP خارجيًا، والأجزاء المزعجة تُدار
كل أداة أتمتة تعلن عن عدد من التكاملات. العدد دائمًا كبير ودائمًا السؤال الخاطئ، لأن النظام الذي تحتاجه فعلًا هو الذي بُني داخليًا عام 2014 على يد شخص رحل. ما يهم هو مدى إتقان الأداة للبروتوكول الذي تقوم عليه جميعها.
التوصيلات الجاهزة
التطبيقات التي تعمل عليها معظم الشركات لها خطوات مُعدّة: المتاجر والأسواق، والمحاسبة والفوترة، وجداول البيانات وقواعد البيانات، والتقاويم والبريد، والتخزين والمراسلة، وأنظمة إدارة العملاء ومكاتب الدعم، ومزوّدو الدفع وشركات الشحن. تُصرّح بالحساب مرة واحدة وتُسمّى الحقول بلغة التطبيق نفسه، لا بلغة JSON الخاصة به.
وحيثما يكون للتطبيق خصوصية في السوق البولندية — نظام فوترة يجب أن يكون جاهزًا لـ KSeF، أو شركة شحن ملصقاتها معيار وطني — فالخطوة المُعدّة تعرف بذلك، لأن العائلة تبيع في ذلك السوق وكان عليها أن تتعلم.
ثم الحالة العامة
كل ما عدا ذلك خطوة HTTP، وخطوة HTTP هنا ليست جائزة ترضية. إنها الآلية نفسها التي بُنيت عليها التوصيلات الجاهزة، وبها المعالجة نفسها للأجزاء التي يُتعب كتابتها بنفسك.
الأجزاء المزعجة
مُدارة، فلا تعيد كتابتها
المصادقة
مفاتيح API، ورموز الحامل، والمصادقة الأساسية، وOAuth 2 مع التجديد، وتوقيع الطلبات بـ HMAC، وTLS المتبادل. تُخزَّن بيانات الاعتماد مرة واحدة، ويُشار إليها بالاسم، ولا تُطبع أبدًا في سجل أو سجل تنفيذ.
ترقيم الصفحات
المؤشرات، وأرقام الصفحات، والإزاحات، وترويسات Link، وواجهة API التي تُشير إلى النهاية بإرجاع مصفوفة فارغة. قل أي شكل هي عليه وتمشي الخطوة عبر المجموعة كاملة.
حدود المعدل
حد أقصى لكل اتصال، يُحترم في كل سير عمل يستخدمه. عندما يرد المزوّد بالرمز 429 مع Retry-After، تنتظر الخطوة تلك المدة بدل الإلحاح المتكرر.
إعادة المحاولات والتراجع التدريجي
الأعطال العابرة يُعاد تجربتها بفاصل زمني متزايد وبحد أقصى. الخطوة دالة نقية لمدخلاتها، لذا تعيد المحاولة تشغيل الخطوة نفسها لا تشغيل السير عمل كاملاً.
الحمولات الصعبة
JSON، ترميز النماذج، XML، نص عادي، رفع multipart. تُحلَّل الاستجابات إلى حقول يمكنك الإشارة إليها بالاسم، بما فيها الحقول المتداخلة أربعة مستويات في العمق.
المهلات الزمنية
حد زمني لكل خطوة، حتى لا يحتجز تبعية بطيئة واحدة عاملاً بينما يتراكم ما بعدها في الانتظار. ما يحدث عند بلوغ الحد هو قرارك، لكل خطوة على حدة.
إذا كان النظام يتحدث HTTP، فالحوار قد بدأ بالفعل.
خطافات الويب الواردة، تؤخذ على محمل الجد
لكل سير عمل رابط يبدؤه. يتحقق هذا الرابط من التواقيع — HMAC بالأشكال التي تستخدمها المزوّدات الشائعة، وسر مشترك حيث لا يستطيع المرسل أكثر من ذلك. الطلب غير الموقَّع إلى سير عمل يتوقع توقيعاً يُرفض ويُسجَّل، ولا يُعالج بصمت.
إزالة التكرار تعتمد على معرّف الحمولة نفسه، فالمرسل الذي يعيد الإرسال لأنه لم يرَ 200 منك في الوقت المناسب يحصل على تشغيل واحد لا ثلاثة. الحمولات المشوّهة تُحفظ مع سبب رفضها، لأن السبب الأكثر شيوعاً لفجوة غامضة في الأتمتة هو مرسل غيّر رأيه بشأن حقل ما.
الأنظمة التي لا تتحدث إلا بـ CSV
وهي موجودة فعلاً. يظهر ملف على خادم SFTP في الرابعة فجراً، أو يصل كمرفق، أو يُلقى في مجلد مشترك. يمكن لسير العمل أن يراقبه ويقرأه ويعامل كل صف كسجل — بما في ذلك الملف ذو علامة ترتيب البايتات، والفواصل المنقوطة، وصف رؤوس بالبولندية، لأن هذا هو شكل التصدير الفعلي.
والاتجاه المعاكس يعمل أيضاً: يمكن لسير العمل أن يبني ملفاً ويضعه حيث يتوقع النظام الآخر أن يجده، وهو غالباً الواجهة الوحيدة لبرنامج صدر عام 2006.
- ⚡مشغّلملف جديد على SFTP المورّد:
stock-2026-09-09.csv. - 2التحليلفواصل منقوطة، علامة ترتيب البايتات، رؤوس بولندية. 4 118 صفاً.
- 3التوحيدرُوجعت رموز العملات مقابل البيانات المرجعية؛ ورُفض اثنان لعدم صلاحيتهما.
- 4دفعHTTP
PATCHعلى دفعات من 200، مع احترام حد المعدل. - !الاستثناءاتصفان أُودعا لشخص واحد، مع رقم الصف والسبب. أما الصفوف الأخرى البالغة 4 116 فقد مرّت.
الخطوات التي استدعت نموذجاً: 0تكلفة هذا التشغيل: لا شيء
أين تُحفظ بيانات الاعتماد
مشفّرة، يُشار إليها بالاسم، محدودة بنطاق مساحة العمل التي تملكها، ولا تُعرض أبداً في سجل تشغيل أو رسالة خطأ أو محادثة دعم. يُظهر سجل التشغيل أن الخطوة استوثقت باسم supplier-sftp؛ لكنه لا يُظهر ما هو supplier-sftp.
الوكالة التي تشغّل سير عمل واحداً لثلاثين عميلاً تمنح كل عميل مجموعة بيانات اعتماد خاصة به، ويشير سير العمل إلى المجموعة لا إلى السر. تدوير المفتاح تعديل واحد في مكان واحد — وهذا هو السبب الأكبر لقدوم الوكالات إلى هنا.
الحد الذي يستحق المعرفة: النظام الذي لا يملك أي واجهة على الإطلاق — لا واجهة برمجية، ولا خطاف ويب، ولا إفلات ملفات، لا شيء سوى شخص ينقر في متصفح — لا يمكن أتمتته بهذا ولا بأي شيء آخر صادق. لا يوجد هنا متصفح بلا واجهة يتظاهر بأنه مستخدم، لأن ذلك ينكسر أول مرة ينقل فيها الطرف الآخر زراً، وينكسر بصمت.