بوابة المطورين: webhooks وREST API وأنماط التكامل

الوكالات والفرق الداخلية تربط مِرفقي بالمحاسبة وإدارة المستودعات وتطبيقات الموبايل المخصصة عبر بوابة المطورين. Webhooks توصّل أحداثاً شبه فورية؛ REST API يغطي CRUD للكتالوج والطلبات والعملاء بمفاتيح محددة بـ OAuth.

نظرة على بوابة المطورين

سجّل كشريك، أنشئ تطبيقات، وأدر بيانات اعتماد التجريب مقابل الإنتاج. اقرأ الأدلة على mrfqy.com/developers/docs وافتح البوابة من لوحة التحكم → التطبيقات → المطورين.

متاجر الاختبار تتيح إعادة تشغيل حمولات webhook دون لمس بيانات التاجر الحية.

Webhooks والتوقيعات

اشترك في order.created وorder.paid وأحداث دورة dropship. الكتalog الكامل على mrfqy.com/developers/docs/webhooks.

تحقق من توقيعات HMAC عبر @mrfqy/sdk/node قبل المعالجة — ارفض الإعادات الأقدم من خمس دقائق.

أنماط REST API

استخدم ترقيم الصفحات بالمؤشر على نقاط القائمة. وسّع الكائنات المرتبطة باعتدال — اجلب بنود الطلب في استدعاء ثانٍ عند كبر الدفعة.

رؤوس Idempotency-Key على طلبات POST تمنع شحنات مكررة عند تذبذب الشبكة.

وصفات تكامل ERP وWMS

النمط الشائع: webhook يدفع الطلب للطابور، العامل يربط الرموز برموز ERP، ينشر الفاتورة، يكتب التتبع عبر API.

مزامنة المخزون ليلاً من ERP لخانات مستودع مِرفقي — webhooks الأحداث تعالج التعديلات خلال اليوم.

أطلق تطبيقاً إنتاجياً

أكمل مراجعة الأمان، ووثّق تنظيف إلغاء التثبيت، وانشر لدليل السوق عند الجاهزية.

راقب لوحات فشل webhook — التجار يعتمدون على وقت تشغيلك خلال الجمعة البيضاء وذروات رمضان.