بوابة المطورين: webhooks وREST API وأنماط التكامل
اشترك بأحداث الطلبات والمخزون، تحقق من التوقيعات، وابنِ موصلات ERP — الدليل التقني للمكاملين العرب.
الوكالات والفرق الداخلية تربط مِرفقي بالمحاسبة وإدارة المستودعات وتطبيقات الموبايل المخصصة عبر بوابة المطورين. Webhooks توصّل أحداثاً شبه فورية؛ REST API يغطي CRUD للكتالوج والطلبات والعملاء بمفاتيح محددة بـ OAuth.
نظرة على بوابة المطورين
سجّل كشريك، أنشئ تطبيقات، وأدر بيانات اعتماد التجريب مقابل الإنتاج. التوثيق يغطي مسارات المصادقة وحدود المعدل ورموز الخطأ.
متاجر الاختبار تتيح إعادة تشغيل حمولات webhook دون لمس بيانات التاجر الحية.
Webhooks والتوقيعات
اشترك في order.created وorder.paid وfulfillment.updated وinventory.adjusted. كل حمولة تتضمن معرف المتجر وطابع الحدث لمعالجات idempotent.
تحقق من توقيعات HMAC بسر التطبيق قبل المعالجة — ارفض الإعادات الأقدم من خمس دقائق.
أنماط REST API
استخدم ترقيم الصفحات بالمؤشر على نقاط القائمة. وسّع الكائنات المرتبطة باعتدال — اجلب بنود الطلب في استدعاء ثانٍ عند كبر الدفعة.
رؤوس Idempotency-Key على طلبات POST تمنع شحنات مكررة عند تذبذب الشبكة.
وصفات تكامل ERP وWMS
النمط الشائع: webhook يدفع الطلب للطابور، العامل يربط الرموز برموز ERP، ينشر الفاتورة، يكتب التتبع عبر API.
مزامنة المخزون ليلاً من ERP لخانات مستودع مِرفقي — webhooks الأحداث تعالج التعديلات خلال اليوم.
أطلق تطبيقاً إنتاجياً
أكمل مراجعة الأمان، ووثّق تنظيف إلغاء التثبيت، وانشر لدليل السوق عند الجاهزية.
راقب لوحات فشل webhook — التجار يعتمدون على وقت تشغيلك خلال الجمعة البيضاء وذروات رمضان.