واجهة شركاء وميض: اربط برمجياتك بمتجرك بمفاتيح API وويب هوك موقّعة
امنح مطوّريك أو نظام ERP أو متجرك الإلكتروني وصولاً آمناً إلى كتالوج فرع وطلباته ومخزونه وعملائه وتقاريره عبر واجهة شركاء وميض، وادفع الأحداث — طلبات جديدة وتغيّرات مخزون ونتائج زاتكا — إلى أنظمتك بويب هوك موقّعة. مفتاح لكل تكامل، لكلٍّ الصلاحيات التي يحتاجها فقط.
4 دقائق قراءة
تربط واجهة شركاء وميض برمجياتك بمتجرك. تمنحواجهة REST موثّقة (OpenAPI) مطوّريك أو نظام ERP أو متجرك الإلكتروني وصولاً آمناً إلى كتالوج فرع وطلباته ومخزونه وعملائه وتقاريره، وتدفعويب هوك موقّعة بإعادة محاولة تلقائية الطلبات الجديدة وتغيّرات المخزون ونتائج زاتكا إلى أنظمتك. وتنشئمفتاحاً لكل تكامل بصلاحياته وانتهائه. المؤسسية (وصول API)؛ نحو 5 دقائق.روجع في نوفمبر 2026.
ما يفعله تكامل واجهة شركاء وميض
- واجهة REST موثّقة بـOpenAPI مع مرجع للمطورين.
- مفتاح لكل تكامل بصلاحياته — الكتالوج أو الطلبات أو المخزون أو العملاء أو التقارير أو الويب هوك — وتاريخ انتهاء اختياري.
- ويب هوك موقّعة بإعادة محاولة تلقائية إلى عنوان HTTPS الخاص بك للأحداث التي تختارها.
- الاستخدام اليومي لكل مفتاح وآخر طلب لكل مفتاح.
ما تحتاجه
- باقة تتضمنوصول API (المؤسسية؛ وتدرج صفحة الأسعار أيضاً إضافة وصول API).
- مطور أو نظام يستطيعاستدعاء واجهة REST.
- وللويب هوكعنوان HTTPS لنظامك يمكن الوصول إليه من الإنترنت.
الإعداد في 5 خطوات
- افتح شاشة واجهة الشركاء (واجهة الشركاء ← المفاتيح).
- اضغطمفتاح جديد وسمِّه (مثلاً «المتجر الإلكتروني») واختر صلاحياته وتاريخ انتهاء إن شئت.
- انسخ السر الآن: يبدأ بـ
sk_ويُعرض مرة واحدة؛ ولا يُحفظ منه إلا بصمة. وإن فُقد فبدّل المفتاح لتحصل على جديد. - يرسل نظامك السررمز Bearer مع كل طلب إلى عنوان الواجهة المعروض؛ وتسرد وثائق المطورين كل نقطة نهاية بأمثلة.
- اختياري: في تبويبالويب هوك أضف عنوان HTTPS لنظامك واختر الأحداث؛ فيرسل وميض كل حدث إليه موقّعاً.
ما يجب معرفته — وما لا يفعله
- يعمل المفتاح لهذا الفرع فقط؛ أنشئ واحداً لكل فرع في حالة عدة فروع.
- أعطِ كل مفتاحالصلاحيات التي يحتاجها نظامه فقط؛ ويمكنكسحب المفتاح في أي وقت فتتوقف طلباته فوراً.
- يحمل كل تسليم ويب هوك
X-Wameed-Signature: t=<الوقت>,v1=<HMAC-SHA256 للنص "الوقت.المحتوى" بسر نقطة النهاية>—ارفض ما هو أقدم من 5 دقائق وأزل التكرار بـX-Wameed-Delivery. - عنوان ويب هوكيفشل باستمرار يُوقف تلقائياً؛ أصلحه وأعد تشغيله من تبويب الويب هوك. ويمكنتبديل سر التوقيع المفقود أو المسرَّب — فيتوقف القديم فوراً.
- يعرض وميض تنبيهات حين تنتهي كل المفاتيح أو يقترب مفتاح من الانتهاء أو يُوقف ويب هوك. وبرمجياتك هي التي تتصل بوميض لا العكس، فلاشيء لتختبره من شاشة التكامل.
- سوق تطبيقات الأطراف الثالثة صغير؛ وتثبيت تطبيق يصدر مفتاح شريك بالصلاحيات التي توافق عليها بالضبط، وإلغاء التثبيت يسحبه.
موقعه في وميض
واجهة الشركاء هي الطريق لما لا يأتي جاهزاً في المركز — مثلاً ربط مخصص بسلة أو زد أو نظام ERP أو أداة ذكاء أعمال أو تطبيقك الخاص. وهي جانب المطورين من قصةأفضل تكاملات نقاط البيع؛ فالموصّلات المباشرة تغطي المدفوعات والتوصيل والمحاسبة وواتساب والرسائل والبريد والتحليلات وزاتكا. اقرأصفحة الميزة وسوق التطبيقات.
إجابات أخرى
أفضل تكاملات نقاط البيع ·صفحة ميزة واجهة الشركاء ·كل التكاملات
الأسئلة الشائعة
أي باقة تتضمن واجهة الشركاء؟
المؤسسية (وصول API). وتدرج صفحة الأسعار أيضاً إضافة وصول API؛ فتحقق من الباقات التي تُضاف إليها.
كيف أؤمّن الويب هوك؟
تحقق من X-Wameed-Signature (HMAC-SHA256 للنص «الوقت.المحتوى» بسر نقطة النهاية) وارفض ما هو أقدم من 5 دقائق وأزل التكرار بـX-Wameed-Delivery.
هل يخدم مفتاح واحد عدة فروع؟
لا. يعمل المفتاح لفرع واحد؛ أنشئ واحداً لكل فرع.
هل هناك موصّل جاهز لسلة أو زد؟
لا. استخدم واجهة الشركاء لربط مخصص.
- #واجهة برمجية
- #واجهة الشركاء
- #ربط الأنظمة
- #ويب هوك
- #Partner API
- #Wameed Partner API
- #REST API OpenAPI webhooks
- #POS API Saudi Arabia
شارك المقال
اقرأ أيضاً
4 دقائق قراءة
زاتكا (فاتورة) مع وميض POS: الفوترة الإلكترونية المرحلة الثانية لكل بيعة، بتفعيل برمز لمرة واحدة
وميض POS حل للفوترة الإلكترونية المرحلة الثانية. تُوقَّع كل بيعة بالختم التشفيري لهذا الفرع وتحمل رمز QR لزاتكا وتُرسَل إلى زاتكا عبر منصة فاتورة — فتُبلَّغ الفواتير المبسطة (B2C) خلال 24 ساعة وتُخلَّص الفواتير القياسية (B2B) قبل إصدارها. ويحتاج التفعيل كلمة مرور لمرة واحدة من حسابك في بوابة فاتورة.
4 دقائق قراءة
واتساب للأعمال مع وميض POS: تحدّث إلى عملائك على واتساب من رقم نشاطك الخاص
اربط رقم واتساب للأعمال الخاص بك عبر Embedded Signup من Meta. تصل رسائل العملاء إلى وميض POS، وتخرج تحديثات الطلب والحجز من رقمك، وتختار الفروع التي يخدمها كل رقم. وتفوتر Meta رسوم رسائل واتساب حسابك أنت لديها؛ ووميض لا يضيف هامشاً.
4 دقائق قراءة
مايكروسوفت كلاريتي مع وميض POS: خرائط حرارية وتسجيلات جلسات لمتجرك الإلكتروني
اعرف كيف يستخدم المتسوقون متجرك فعلاً بالخرائط الحرارية وتسجيلات الجلسات من مايكروسوفت كلاريتي. يضيف وميض وسم كلاريتي بعد قبول الزائر فقط، ويعلّم كل خطوة تسوق حدثاً في كلاريتي، ويُبقي جلسات الدفع والشراء حين تأخذ كلاريتي عينات، ويخفي تفاصيل الطلب والدفع والحجز في التسجيلات.

