Overview
واجهة API للشركاء (B2B)
A server-to-server API for B2B resellers and partners with a partner portal account to read the esimoa product catalog.
On this page
Who it is for#
واجهة Partner API مخصصة لموزعي B2B ووكالات السفر والشركاء من الشركات الذين لديهم عقد مع esimoa وحساب في بوابة الشركاء. يمكن لخوادمك قراءة كتالوج المنتجات نفسه الذي تبيعه esimoa وبناء أدوات البيع أو الدعم الخاصة بك عليه.
الأسعار (priceKRW) هي أسعار البيع بالتجزئة لدى esimoa بـ KRW. لا تتضمن الاستجابات أبدًا معلومات المورّد أو التكلفة.
البقشيش
هل تدير مدونة أو موقع مقارنة أو منتجًا للذكاء الاصطناعي؟ API العامة متاح للجميع ويمنحك عمولة.
Getting access#
- 1طلب شراكة — تواصل معنا أولًا. تراجع esimoa الطلب وتنشئ الحساب لك.
- 2يتلقى مالك الحساب (OWNER) رسالة دعوة بالبريد الإلكتروني. يعمل الرابط مرة واحدة خلال 72 ساعة؛ عيّن كلمة مرور وسيتم تسجيل دخولك.
- 3بوابة الشركاء → مفاتيح API: أنشئ مفتاحك الأول.
عنوان URL الأساسي#
url
https://api.esimoa.com/b2b/v1تحذير
استخدم واجهة API هذه من الخادم الخلفي. لا يسمح CORS بالاستدعاءات من المتصفح عبر مواقع خارجية. لا تضمّن المفتاح أبدًا في كود الواجهة الأمامية أو التطبيق.
نقاط النهاية#
| نقطة النهاية | الوصف |
|---|---|
| GET /b2b/v1/products | ابحث عن المنتجات |
| GET /b2b/v1/products/:id | منتج واحد |
| GET /b2b/v1/countries | البلدان التي تتوفر فيها منتجات |
تتطلب كل نقاط النهاية catalog:read ضمن نطاقات المفتاح (ممنوح افتراضيًا).
Response envelope#
عند النجاح تكون النتيجة في data، وتتضمن القوائم أيضًا total وpage وlimit. تحمل الأخطاء قيمة code — الرسالة باللغة الإنجليزية وقد تتغير، لذا اعتمد على code في التفرع.
json
// Success
{ "success": true, "data": ..., "total": 128, "page": 1, "limit": 20 }
// Error
{ "statusCode": 401, "code": "INVALID_API_KEY", "message": "The API key is invalid." }Compared to the Public API#
| واجهة API للشركاء (B2B) | API العامة (/v1) | |
|---|---|---|
| إصدار المفاتيح | بوابة الشركاء | لوحة تحكم مركز المطوّرين |
| ترقيم الصفحات | page (1~) · limit ≤ 50 | offset · limit ≤ 50 |
| حقل السعر | priceKRW | priceKrw |
| رابط الشراء | لا شيء — تخضع المبيعات لعقدك | url (مع رمز الشريك) |
| معلومات المورّد | غير مشمول | provider |
| حد المعدل | 300/دقيقة لكل مفتاح (قابل للتعديل لكل حساب) | 600/دقيقة لكل شريك |