بوابات الدفع
eSewa وKhalti وStripe وPayPal وبوابات البنوك، بما في ذلك الاستدعاءات الراجعة والتحقق ومعالجة المبالغ المستردة.
ربط الواجهات البرمجية — نيبال
ربط الواجهات البرمجية من نيبالمصمَّم لحالات الأعطال
تربط Soft Himalaya من كاتماندو بوابات الدفع وأنظمة إدارة العملاء وأنظمة تخطيط الموارد وشركات الشحن والواجهات البرمجية المخصصة، لشركات في نيبال والمملكة المتحدة وأستراليا والولايات المتحدة وكندا.
- الاتفاق أولًا على مطابقة الحقول وملكية السجلات
- معالجة مقصودة لإعادة المحاولة والتكرار وانتهاء المهلة
- سجلات وتنبيهات تكشف الأعطال مبكرًا
هندسة لأنظمة حقيقية
ملكية الحقول وبيانات الاعتماد وإعادة المحاولة والتنبيهات تُصمَّم قبل أن تنتقل البيانات بين الأنظمة.
- العقد أولًا
- يُتفق على نقاط الوصول والحقول وأشكال الأخطاء وتُوثَّق قبل أن يكتب أي طرف شيفرة تعتمد عليها.
- إعادة المحاولة بأمان
- تُصمَّم عمليات الكتابة لتكون متساوية الأثر، فلا ينشئ تكرار الطلب بعد انتهاء المهلة طلبًا أو دفعة مكررة.
- الأعطال ظاهرة
- تسجّل عمليات الربط الحدث وتُطلق تنبيهًا حين يتعطل طرف خارجي، بدل أن تفشل بصمت وتضيع السجلات.
- بيانات اعتماد تُدار كما ينبغي
- المفاتيح في متغيرات البيئة أو مخزن الأسرار، لا في المستودع أبدًا، وصلاحياتها محصورة فيما يحتاجه الربط.
ما الذي نربطه
ربط الأنظمة التي تشغّلها بالفعل
معظم أعمال الربط ليست غريبة. إنها جعل نظامين يتفقان على ماهية العميل أو الطلب أو الفاتورة، ومعالجة الحالات التي يكون فيها أحدهما غير متاح.
إدارة العملاء وأدوات المبيعات
مزامنة جهات الاتصال والصفقات والأنشطة بين موقعك ونماذجك ونظام إدارة العملاء الذي يعمل عليه فريقك.
تخطيط الموارد والمحاسبة
تبادل الفواتير والمخزون وقيود الدفاتر مع النظام المحاسبي أو نظام تخطيط الموارد المعتمد.
الشحن والتوصيل
حجز الشحنات وإصدار الملصقات والاستعلام عن الأسعار وحالة التتبع، معروضة داخل واجهتك أنت.
الرسائل النصية والبريد والإشعارات
رسائل المعاملات عبر مزوّدي الخدمة، مع معالجة صريحة لحالة التسليم وسلوك إعادة المحاولة.
مزامنة المتاجر الإلكترونية والقنوات
مزامنة الكتالوج والمخزون والطلبات بين منصتك والمتاجر الإلكترونية التي تبيع عليها.
واجهات REST وGraphQL مخصصة
واجهات برمجية لمنتجاتك أو شركائك، مع إدارة الإصدارات والمصادقة والتوثيق.
الويب هوك ومعالجة الأحداث
استقبال الأحداث الواردة والتحقق منها ووضعها في طابور ومعالجتها، فلا تضيع السجلات عند تدفق مفاجئ.
جسور للأنظمة القديمة وقواعد البيانات
إتاحة الأنظمة القديمة عبر واجهة محددة بدل السماح بالوصول المباشر إلى قاعدة بياناتها.
لماذا يهم هذا
التكلفة تكمن في حالات الأعطال
ربط نظامين في يوم هادئ أمر بسيط. العمل الذي يستحق أن تدفع مقابله هو ما يحدث حين تنتهي مهلة المزوّد أو يغيّر حقلًا أو يقيّد طلباتك أو يرسل الحدث نفسه مرتين.
إعادة الإدخال اليدوي مكلفة
نسخ الموظفين للطلبات بين الأنظمة بطيء، ويُنتج تباينات لا تظهر إلا بعد أسابيع أثناء المطابقة.
الأطراف الخارجية تتعطل
لدى المزوّدين أعطال ونوافذ صيانة. الطوابير وإعادة المحاولة وسلوك بديل واضح تُبقي جانبك يعمل ريثما يتعافى جانبهم.
التكرار هو الخلل المعتاد
انتهاء المهلة لا يعني فشل الطلب. بدون مفاتيح منع التكرار والمطابقة، تتحول إعادة المحاولة إلى خصم ثانٍ أو شحنة ثانية.
الواجهات البرمجية تتغير
تُلغى حقول وتُسحب إصدارات. تحتاج عمليات الربط إلى مراقبة ومسؤول عنها، لا إلى بناء لمرة واحدة ثم الأمل.
طريقة عملنا
نخطط ونبني ثم نكسر عمدًا
تعتمد المدة على جودة توثيق المزوّد وتوافر بيئة الاختبار وسرعة وصول بيانات الاعتماد والموافقات — وغالبًا ما يكون هذا أبطأ جزء في العمل.
- 01
الاستكشاف ومراجعة التوثيق
نقرأ توثيق الواجهة البرمجية لدى المزوّد، ونتأكد مما تسمح به خطتك فعلًا، ونحدد حدود الطلبات وبيئات الاختبار وخطوات الموافقة.
- 02
مطابقة البيانات والعقد
تُطابق الحقول بين الأنظمة، ويُحدد مصدر الحقيقة لكل سجل، وتُوثَّق الواجهة قبل التنفيذ.
- 03
التنفيذ في بيئة الاختبار
يُبنى الربط على بيئة الاختبار لدى المزوّد، مع إبقاء بيانات الاعتماد خارج الشيفرة منذ البداية.
- 04
تصميم الأخطاء وإعادة المحاولة
انتهاء المهلة والأعطال الجزئية والأحداث المكررة وحدود الطلبات تُعالج عن قصد، مع ضمان تساوي الأثر حيث تُنشأ السجلات.
- 05
اختبار مسارات الفشل
نختبر الحالات السيئة لا الجيدة فقط: المزوّد متوقف، استجابة مشوهة، ويب هوك مُعاد إرساله، بيانات اعتماد منتهية.
- 06
النشر والمراقبة
ينطلق الربط مع التسجيل والتنبيهات ودليل تشغيل موثّق، لتلاحظ أنت العطل قبل أن يلاحظه عميل.
تخطيط الربط
أربعة قرارات يحتاجها كل ربط
بدل عرض لوحات مختلَقة لطلبات عالجناها، هذه هي القرارات التي تحدد ما إذا كان الربط موثوقًا أم تذكرة دعم متكررة.
نموذج المصادقة
مفاتيح API أو OAuth أو طلبات موقّعة — إضافة إلى كيفية تدوير بيانات الاعتماد ومن يحتفظ بها.
مطابقة البيانات
أي نظام يملك كل حقل، وكيف تُطابق السجلات، وماذا يحدث حين يغيّر الطرفان السجل نفسه.
السلوك عند الفشل
سياسة إعادة المحاولة والتراجع التدريجي ومعالجة الرسائل المتعذرة، وما يراه المستخدم أثناء تعذر الوصول إلى المزوّد.
المراقبة والتنبيهات
ما الذي يُسجَّل، وما الذي يُطلق تنبيهًا، ومن يُنتظر منه التحرك حين يتوقف الربط.
تُسجَّل بيانات الاعتماد وحسابات المزوّدين باسم شركتك، فلا يعتمد الوصول علينا.
الأدوات
ما نبني به
تتبع اختيارات التقنية الأنظمةَ التي يجري ربطها وما يستطيع فريقك صيانته لاحقًا.
Node.js وTypeScript
خدمات الربط والويب هوك وطبقات الواجهات البرمجية
Laravel وPHP
عمليات ربط داخل تطبيقات PHP القائمة
Python
مزامنات كثيفة البيانات ومهام مجدولة
REST وGraphQL
تصميم الواجهات وإدارة الإصدارات والتوثيق
الطوابير والعمّال
إعادة المحاولة والتراجع التدريجي ومعالجة الذروات
PostgreSQL وRedis
تخزين السجلات ومفاتيح منع التكرار والتخزين المؤقت
الأمان والموثوقية
ممارسات لا ضمانات
لا يوجد ربط لا يمكن كسره، وأي وكالة تدّعي ضمانًا أمنيًا تبالغ. ما نستطيع الالتزام به هو مجموعة ممارسات تُطبَّق باتساق، وشرح واضح لما يفعله الربط ببياناتك.
إدارة بيانات الاعتماد
المفاتيح في متغيرات البيئة أو مخزن للأسرار، لا في المستودع أبدًا، ومحصورة في الحد الأدنى الذي يحتاجه الربط.
النقل والتحقق
تمر الطلبات عبر TLS، ويُرفض أي ويب هوك وارد ما لم يتحقق توقيعه مقابل سرّ المزوّد.
حدود الطلبات والتراجع التدريجي
تحترم الطلبات الحدود المعلنة لدى المزوّد، مع تراجع أُسّي وطوابير بدل الضغط المتواصل على نقطة وصول متعثرة.
انضباط في البيانات والسجلات
لا تُسجَّل البيانات الشخصية وبيانات الدفع إلا حيث يلزم، وتُحجب حيث لا يلزم، وتُحفظ وفق ما تتفق عليه.
تقديرات المشاريع
النطاق أولًا، ثم السعر
تعتمد التكلفة على جودة الواجهة البرمجية لدى المزوّد، وعدد الأنظمة المعنية، ووجود بيئة اختبار، وحجم منطق المطابقة المطلوب. نراجع التوثيق قبل تقديم السعر.
ربط واحد
مزوّد واحد يُربط بنظام واحد — بوابة دفع أو شركة شحن أو خدمة رسائل.
- مراجعة التوثيق
- التنفيذ في بيئة الاختبار
- معالجة الأخطاء وإعادة المحاولة
- النشر والتسليم
مزامنة عدة أنظمة
نظامان أو أكثر يبقيان متوافقين، مع قواعد للملكية ومطابقة بينها.
- مطابقة الحقول والملكية
- مزامنة مجدولة ومبنية على الأحداث
- معالجة التكرار والتعارض
- المراقبة والتنبيهات
منصة واجهات برمجية مخصصة
واجهة برمجية تتيحها لشركائك أو لتطبيقاتك، مع إدارة الإصدارات والتوثيق.
- تصميم الواجهة
- المصادقة وحدود الطلبات
- توثيق منشور
- خطة للدعم والإصدارات
أسئلة
الأسئلة الشائعة
أسئلة متكررة عن المزوّدين والمدد الزمنية ومعالجة الأعطال وكيفية تسعير أعمال الربط.
هو ربط نظامين بحيث يتبادلان البيانات دون أن يعيد أحد إدخالها يدويًا، مثل ربط موقع إلكتروني بنظام CRM، أو متجر بشركة شحن، أو تطبيق ببوابة دفع. ويتمثل معظم العمل في تحديد النظام المسؤول عن كل سجل، وما الذي يحدث عندما يكون أحدهما غير متاح.
العمل معًا
علاقة واضحة في مشاريع الربط
لا ننشر شهادات عملاء مجهولة ولا نسب جاهزية ولا رسومًا بيانية لحجم الطلبات لا يمكن التحقق منها. هذه هي المعايير التي نُلزم أنفسنا بها بدلًا من ذلك.
واجهات موثّقة
الحقول ونقاط الوصول ورموز الأخطاء وسلوك إعادة المحاولة تُكتب وتُسلَّم، لا تبقى في ذهن مطوّر واحد.
بيانات الاعتماد تبقى لك
تُفتح حسابات المزوّدين باسم شركتك، ويكون وصولنا محدود النطاق وقابلًا للإلغاء.
حالات الفشل مُختبرة
نُريك ما يحدث حين يتوقف المزوّد أو يُرجع خطأ، لا أن المسار الطبيعي يعمل فحسب.
تسليم يمكنك صيانته
الشيفرة المصدرية وإعدادات البيئة ودليل تشغيل للأعطال الشائعة تُسلَّم لمن يتولى دعم النظام بعدنا.
ابدأ مشروعًا
أخبرنا بالأنظمةالتي يجب أن تتواصل
أرسل الأنظمة المعنية، وروابط توثيق الواجهة البرمجية لدى المزوّد إن توفرت، وما يجري حاليًا يدويًا. سنرد بأسئلتنا وبنطاق مقترح وتقدير للتكلفة.