Getting started
مقدمة
Documentation for the REST APIs and MCP server that bring esimoa eSIMs to your website, app or AI assistant.
What you can build#
- واجهة API للبحث عن eSIM — ابحث عن شرائح eSIM من esimoa حسب الدولة والمدة والبيانات، واعرضها بأسعار مباشرة على موقعك أو تطبيقك.
- عمولة رابط التتبع — يتضمن كل رابط شراء في استجابة API رمز الشريك الخاص بك. عندما يدفع العميل عبره، تحصل على عمولة.
- عمليات التكامل مع الذكاء الاصطناعي (MCP) — اربط خادم MCP من esimoa بـ ChatGPT أو Claude أو Gemini ليتمكن الذكاء الاصطناعي من البحث عن شرائح eSIM ومقارنتها وإضافة روابطها.
- واجهة API للشركاء (B2B) — يمكن للموزعين والشركاء المتعاقدين بنظام B2B جلب كتالوج منتجات esimoa من جانب الخادم لبناء متاجرهم الخاصة.
Which API should I use?#
لدى esimoa واجهتا REST API بمفاتيح منفصلة. لمعظم المواقع والمدونات ومنتجات الذكاء الاصطناعي، تكفي Public API.
| API العامة (/v1) | واجهة API للشركاء (B2B) | |
|---|---|---|
| الفئة المستهدفة | المسوّقون بالعمولة — أي شخص لديه حساب esimoa | الموزعون والشركاء المتعاقدون بنظام B2B |
| إصدار المفاتيح | لوحة تحكم مركز المطوّرين | بوابة الشركاء |
| صيغة المفتاح | esk_live_<32> | esk_live_<10>_<40> |
| عنوان URL الأساسي | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| كيف تربح | عمولة على المشتريات عبر روابط التتبع في الاستجابات | حسب عقدك |
طريقة العمل#
- 1سجّل الدخول بحساب esimoa، وأدخل بيانات موقعك، واحصل على رمز الشريك فورًا.
- 2أنشئ مفتاح API من لوحة التحكم. يُعرض المفتاح مرة واحدة فقط.
- 3اعرض المنتجات من API مع url الخاص بها (الذي يتضمن رمز الشريك الخاص بك).
- 4عندما يدفع العميل عبر الرابط، تُسجَّل العمولة في لوحة التحكم الخاصة بك.