مفاتيح API
مفتاح API يربط نظامك، أو نظام وكالة أو شريك تقني يعمل معك، بمنصة نسم عبر واجهة نسم للمطورين (MM-API)، فيقرأ طلباتك ومخزونك ومبيعاتك ويتصرف فيها من نظامه.
ما هو المفتاح
المفتاح يعمل بوصولك أنت: البراندات التي تصل إليها، والصلاحيات التي يملكها حسابك. وتقرأ المنصة صلاحياتك عند كل طلب، فإن تغيّر وصولك تغيّر وصول المفتاح معه. وإن عُطّل حسابك أو خرج من المؤسسة توقفت مفاتيحه.
من ينشئ المفاتيح
كل مستخدم في حساب البراند ينشئ مفاتيحه من حسابه، ويرى مفاتيحه هو. ولكل مستخدم مفتاحان نشطان بحد أقصى.
إنشاء مفتاح
- من القائمة الجانبية في المنصة، تحت «الربط»، افتح «مفاتيح API».
- اضغط «أنشئ مفتاح».
- سمِّ المفتاح باسم النظام الذي سيستخدمه، مثل «مزامنة نظام ERP»، لتميزه حين تسحبه.
- اضغط «أنشئ المفتاح».
نسخ المفتاح
يظهر المفتاح كاملاً مرة واحدة، بعد إنشائه مباشرة.
- اضغط «انسخ المفتاح».
- احفظه في مكان آمن، مثل مدير الأسرار في نظامك، أو سلّمه للمطور الذي يبني الربط.
- علّم «نسخت المفتاح وحفظته في مكان آمن»، ثم اضغط «انتهيت».
بعدها تعرض الصفحة أول أحرف المفتاح فقط، مع تاريخ إنشائه وآخر استخدام له. وإن فقدته، اسحبه وأنشئ غيره.
تبديل المفتاح
بمفتاحين نشطين تبدّل المفتاح والربط يعمل طوال الوقت:
- أنشئ المفتاح الجديد وانسخه.
- ضعه في النظام مكان القديم، وتأكد أن الربط يعمل.
- اسحب المفتاح القديم.
إن كان عندك مفتاحان نشطان، اسحب أحدهما أولاً ثم أنشئ بديله.
سحب المفتاح
- في صفحة «مفاتيح API»، اضغط «اسحب» بجانب المفتاح.
- راجع آخر استخدام له في رسالة التأكيد، ثم اضغط «اسحب المفتاح».
يتوقف فوراً كل نظام يستخدم المفتاح. والمفتاح المسحوب يبقى في القائمة بحالة «مسحوب» للرجوع إليه، وسحبه نهائي. ولإعادة الربط أنشئ مفتاح جديد.
ما يقدر عليه الشريك بمفتاحك
الشريك الذي يحمل مفتاحك يعمل بوصولك:
- يقرأ ما تقرؤه في المنصة: المنتجات والإدراجات، والطلبات، والمخزون، والمبيعات، والربحية والتسويات، وأوامر الشراء، وصحة البراند، وحالة المزامنة.
- ينفّذ ما تسمح به صلاحياتك، مثل إجراءات تنفيذ الطلبات وتحديث الأسعار والكميات.
- تصله إشعارات فورية (webhooks) عند تغيّر طلب أو مرتجع أو أمر شراء أو صحة براند.
وحدود وصوله حدود وصولك: البراندات التي تصل إليها وحدها، والصلاحيات التي يملكها حسابك وحدها. وإنشاء المفاتيح وسحبها يبقى لك من المنصة.
أعطِ كل نظام أو شريك مفتاحه الخاص، لتسحب مفتاح أحدهم ويبقى الآخر يعمل.
للمطورين
دليل المطورين ومرجع الواجهة وبيئة التجربة ببيانات نموذجية في developer.nasam.co. شارك الرابط مع من يبني الربط.
خطوتك التالية
فريق نسم معك أياً كان سؤالك: واتساب +966 55 009 0039 أو general@nasam.co. ودخولك إلى الأسواق نرتبه معك خطوة خطوة، والاستشارة مجانية.