مفاتيح الربط البرمجي (API) والويب هوك

افتح الإعدادات ← الربط البرمجي والويب هوك (يحتاج صلاحية إدارة مفاتيح الربط).

إنشاء مفتاح API

1. في تبويب المفاتيح اضغط مفتاح جديد.
2. اكتب اسمًا يوضح استخدامه (مثل: نظام نقاط البيع)، واختر الصلاحيات التي يحتاجها فقط، والشركة إن أردت حصره بشركة واحدة، وتاريخ انتهاء إن شئت.
3. انسخ المفتاح فورًا. يظهر مرة واحدة فقط ولا نحتفظ إلا ببصمته. إن فقدته ألغه وأنشئ غيره.

أرسله في كل طلب:

Authorization: Bearer mz_live_...
X-Company-Id: <معرّف الشركة>

تجد معرّف الشركة وأمثلة جاهزة في تبويب دليل المطور، والمرجع الكامل في صفحة Swagger.

وضع الاختبار

أنشئ الشركة التجريبية من تبويب النظرة العامة، واستخدم مفاتيح mz_test_ للتجربة دون التأثير على بياناتك أو إرسال شيء للهيئة.

الويب هوك

1. في تبويب الويب هوك أضف عنوان URL لنظامك (https).
2. اختر الأحداث: إصدار فاتورة، وصول دفعة، اعتماد الهيئة، تغيّر المخزون…
3. انسخ السر: كل إشعار يصل موقّعًا به لتتحقق أنه منا.

إذا لم يرد نظامك بنجاح تُعاد المحاولة تلقائيًا بفواصل متزايدة، وتجد كل محاولة في سجل التسليم مع إمكانية إعادة الإرسال.

الأمان

• أعطِ كل نظام مفتاحًا خاصًا بأقل صلاحيات ممكنة.
• ألغِ المفتاح فورًا عند الشك في تسربه.
• لا تضع المفتاح في تطبيق جوال أو صفحة ويب يراها الناس.