ربط أي حاجة
HTTP يدخل، HTTP يخرج، والأجزاء الصعبة مسيّرة
كل أداة أتمتة تعلن على عدد تكاملات. العدد دايماً كبير ودايماً السؤال غالط، لأن النظام اللي تحتاجه فعلاً هو اللي تبني داخلياً في ٢٠١٤ من واحد راح. اللي يهم هو كيف الأداة تحكي البروتوكول اللي تحت كلهم.
الروابط الجاهزة
التطبيقات اللي أغلب الشركات خدامة بيها عندها خطوات جاهزة: المحلات والأسواق، الحسابات والفواتير، جداول البيانات وقواعد البيانات، التقويم والبريد، التخزين والرسائل، أنظمة إدارة العملاء والدعم الفني، مزودي الدفع وشركات الشحن. تُصرّح بالحساب مرة وحدة، والحقول مسمّاة باللغة اللي التطبيق يستعملها، ماشي بلغة الـJSON تاعو.
وين ما كان التطبيق فيه خصوصية للسوق البولندي — نظام فواتير لازم يكون جاهز لـKSeF، ولا شركة شحن ملصقاتها معيار وطني — الخطوة الجاهزة تعرف بيها، لأن العائلة تبيع في ذاك السوق ولازم تتعلم.
وبعدها الحالة العامة
كل شي آخر هو خطوة HTTP، وخطوة HTTP هنا ماشي جائزة ترضية. هي نفس الآلة اللي الاتصالات الجاهزة مبنية عليها، بنفس التعامل مع الأجزاء اللي مملة كي تكتبها بيدك.
الأجزاء المملة
معالجة، باش ما تعاودش تكتبها
المصادقة
مفاتيح API، رموز bearer، المصادقة الأساسية، 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.
الوكالة اللي تشغل سير عمل واحد لثلاثين عميلاً تعطي كل عميل مجموعة اعتمادات تاعو، وسير العمل يشير للمجموعة ماشي للسر. تدوير المفتاح تعديل واحد في بلاصة وحدة — وهذا هو أغلب سبب مجيء الوكالات هنا.
الحد اللي يستحق المعرفة: النظام اللي ما عندو حتى واجهة — لا API، لا ويب هوك، لا إسقاط ملفات، لا شي غير شخص ينقر في متصفح — ما يقدرش يُؤتمت بهذا ولا بأي حاجة صادقة أخرى. ما كاينش متصفح بلا واجهة يتظاهر إنو مستخدم هنا، لأن هذا ينكسر أول مرة الطرف الآخر يحرك زر، وينكسر بهدوء.