استخدام الـ API
ما الغرض من الـ API، وكيف تحصل على مفتاح، وما الذي لا يستطيع أي مفتاح فعله.
ما الغرض منه
كل ما تفعله في اللوحة بطلباتك وشرائح eSIM وأسعارك ومتجرك، تستطيع أنظمتك فعله أيضاً. الأسباب المعتادة: تسوية محاسبية ليلية، وإعادة تسعير مئات الباقات دفعة واحدة، ونقل حالة الطلب إلى الأداة التي يستخدمها فريق الدعم أصلاً.
متاح ضمن خطة Scale. في الخطط الأخرى لا يظهر هذا القسم ولا يمكن إنشاء مفتاح، دون أي أثر آخر على حسابك.
مرجع نقاط النهاية على api.esimbit.com/docs/reseller-api وهو بالإنجليزية فقط: أسماء الحقول ورموز الأخطاء إنجليزية أينما قرأتها، وترجمة متأخرة عن الأصل أسوأ من عدمها. وستجد رابطاً إليه في شاشة مفاتيح API.
الحصول على مفتاح
المفاتيح في قسم مفاتيح API داخل اللوحة، ولا ينشئها إلا مالك الحساب. يبقى المفتاح بعد من أنشأه، وإلغاؤه هو السبيل الوحيد لاستعادته — وهو السبب نفسه الذي يجعل الفوترة ونقل الحساب من صلاحيات المالك.
- افتح قسم مفاتيح API في اللوحة.
- أعطِ المفتاح اسماً ستفهمه بعد ستة أشهر وأنت تقرر ما إذا كان ما زال مستخدماً.
- حدّد النطاقات التي يحتاجها ذلك التكامل فقط. لا يمكن إضافة نطاقات لاحقاً؛ تنشئ مفتاحاً جديداً بدلاً من ذلك.
- ضع تاريخ انتهاء إن أمكن. المفتاح بلا تاريخ انتهاء هو مفتاح لا يراجعه أحد.
- انسخ المفتاح السري. يُعرض مرة واحدة ولا يُعرض بعدها أبداً.
نحن نخزّن بصمة المفتاح فقط، لذا لا توجد شاشة ولا طلب دعم يمكنه عرضه لك مرة ثانية. إن فُقد، أنشئ غيره وألغِ القديم.
ما لا يستطيع أي مفتاح فعله
بعض الأمور تبقى في اللوحة خلف إنسان. هذه ليست ثغرة تُسدّ لاحقاً، بل هي المقصد نفسه.
- المال. المبالغ المستردة، وبدء الدفع، وبوابة الفوترة، والفواتير.
- الأشخاص. الدعوات، وتغيير الأدوار، والإزالة، ونقل ملكية الحساب.
- الأسرار. إنشاء أو حذف اتصال مزود، فهي تحمل بيانات اعتماد مورّدك.
- حذف متجر، وهو ما يأخذ معه كل طلب مرّ به.
- إنشاء مفاتيح أخرى. اعتماد يستطيع إصدار اعتمادات لا يمكن إلغاؤه بإجراء واحد.
كما لا يتجاوز المفتاح دور الشخص الذي أنشأه، ويُعاد التحقق من ذلك مع كل طلب — فخفض دور شخص ما يضيّق مفاتيحه في اليوم نفسه.
أن تُخبَر بدل أن تسأل
شراء eSIM من المزود يجري في الخلفية، لذا لا يستطيع الطلب الذي أنشأ الأمر أن يعيد لك الشريحة. بدلاً من الاستعلام المتكرر حتى تظهر، تسجّل عنوان webhook ونخبرك نحن حين تصبح جاهزة.
كل عملية تسليم موقّعة، ليستطيع نظامك إثبات أنها منّا لا ممن خمّن عنوانك. والعنوان الذي يستمر في الفشل يُوقف مع تسجيل السبب، وتُحفظ كل محاولة — بما فيها الناجحة — ليكون لسؤال «هل أرسلتم؟» جواب حقيقي.