Docs
مركز المطوّرينلوحة التحكمesimoa.com
    • مقدمة
    • بدء سريع
    • المصادقة
    • Overview
    • عرض قائمة شرائح eSIM
    • احصل على eSIM
    • البلدان
    • OpenAPI
    • التتبع والعمولة
    • حدود المعدل والأخطاء
    • Overview
    • Claude
    • ChatGPT
    • Gemini
    • عملاء MCP آخرون
    • Overview
    • المصادقة
    • المنتجات
    • تفاصيل المنتج
    • البلدان
    • Errors & rate limits
  1. Docs
  2. API العامة (/v1)
  3. عرض قائمة شرائح eSIM

API العامة (/v1)

عرض قائمة شرائح eSIM

GET /v1/esims — search eSIMs by country, duration and data, and get purchase URLs that carry your partner code.

On this page
  • Request
  • Query parameters
  • Filter rules
  • الاستجابة
  • The Esim object

Request#

GET/v1/esims
curl "https://api.esimoa.com/v1/esims?country=JP&days=7&sort=price&limit=3&lang=en" \
  -H "X-API-Key: esk_live_your_key_here"
const res = await fetch(
  'https://api.esimoa.com/v1/esims?country=JP&days=7&sort=price&limit=3&lang=en',
  { headers: { 'X-API-Key': process.env.ESIMOA_API_KEY } },
);
if (!res.ok) throw new Error(`esimoa API ${res.status}`);

const { items, total } = await res.json();
for (const esim of items) {
  console.log(esim.title, esim.priceKrw, esim.url);
}
import os
import requests

res = requests.get(
    "https://api.esimoa.com/v1/esims",
    params={"country": "JP", "days": 7, "sort": "price", "limit": 3, "lang": "en"},
    headers={"X-API-Key": os.environ["ESIMOA_API_KEY"]},
    timeout=10,
)
res.raise_for_status()

for esim in res.json()["items"]:
    print(esim["title"], esim["priceKrw"], esim["url"])

Query parameters#

جميع المعلمات اختيارية.

المعاملالنوعالوصف
countrystringرمز البلد (ISO 3166-1 alpha-2، مثل JP)
daysintegerمدة الصلاحية بالأيام بالضبط
minDaysintegerالحد الأدنى للصلاحية (بالأيام)
maxDaysintegerالحد الأقصى للصلاحية (بالأيام)
dataGbnumberالحد الأدنى للبيانات (GB)
unlimitedbooleantrue = الباقات غير المحدودة فقط
sortstringrecommended (افتراضي) | price (الأقل سعرًا أولًا) | data (الأكثر بيانات أولًا)
limitinteger1–50، الافتراضي 10
offsetintegerعدد العناصر المراد تخطيها — يُقرَّب للأسفل إلى مضاعف limit
langstringلغة الاستجابة: ko | en | ja | zh-CN | zh-TW (الافتراضي en)

Filter rules#

  • days يتجاوز minDays وmaxDays.
  • unlimited=true يتجاهل dataGb.
  • تتضمن النتائج المنتجات التي تبيعها esimoa مباشرة فقط، وتُستبعد المنتجات المتوقفة.

الاستجابة#

200 OKjson
{
  "success": true,
  "items": [
    {
      "id": "partner_9VKPYQ3JRYVK5797",
      "title": "Japan · 100 MB · 7 days",
      "countryCode": "JP",
      "countryName": "Japan",
      "coverageCountries": ["JP"],
      "isMultiCountry": false,
      "dataAmount": "100 MB",
      "dataAmountGB": 0.1,
      "isUnlimited": false,
      "dataType": "total",
      "validityDays": 7,
      "priceKrw": 1000,
      "currency": "KRW",
      "provider": "TSIM",
      "networkType": "5G",
      "hotspot": true,
      "hasLocalNumber": false,
      "isLocalNetwork": true,
      "url": "https://www.esimoa.com/en/plans/jp/partner_9VKPYQ3JRYVK5797?ref=p_yourcode&utm_source=esimoa_partner"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0,
  "sort": "price"
}

The Esim object#

الحقلالنوعالوصف
idstringمعرّف المنتج — استخدمه مع نقطة نهاية التفاصيل
titlestringالاسم المعروض (بلغة lang)
countryCode / countryNamestring | nullالبلد الرئيسي (null للباقات متعددة البلدان)
coverageCountriesstring[]رموز البلدان التي تعمل فيها eSIM
isMultiCountrybooleanباقة متعددة البلدان
dataAmount / dataAmountGBstring / numberحجم البيانات (تسمية / رقم بالـ GB)
isUnlimitedbooleanباقة غير محدودة
dataType'total' | 'daily' | nullإجمالي الحصة أو الحصة اليومية
validityDaysintegerالصلاحية بالأيام
priceKrw / currencyinteger / 'KRW'السعر بـ KRW
provider / networkTypestringالمزوّد / الشبكة (مثل 5G)
hotspot / hasLocalNumber / isLocalNetworkbooleanمشاركة الإنترنت / رقم هاتف محلي / شبكة محلية
urlstringرابط شراء يتضمن رمز الشريك الخاص بك (?ref=). اعرضه كما هو.

ملاحظة

تُضاف الحقول فقط، ولا تتغير أسماؤها ومعانيها أبدًا. حلّل الاستجابات بحيث يتم تجاهل الحقول غير المعروفة.

آخر تحديث: ١ أكتوبر ٢٠٢٦

PreviousAPI العامة (/v1)التالياحصل على eSIM

On this page

  • Request
  • Query parameters
  • Filter rules
  • الاستجابة
  • The Esim object

APIs and MCP for bringing esimoa eSIMs to your product

Resources

  • Docs
  • API reference
  • واجهة API للشركاء (B2B)
  • MCP server
  • OpenAPI spec

esimoa

  • الرئيسية
  • eSIM باقات
  • مركز المطوّرين
  • لوحة التحكم
  • بوابة الشركاء

Company

  • من نحن
  • الشراكات
  • شروط الخدمة
  • سياسة الخصوصية
  • سياسة التسليم والاسترداد

الدعم

  • support@esimoa.com
  • محادثة الدعم

NBase Korea Co., Ltd.

902, Bldg A, 767 Sinsu-ro, Suji-gu, Yongin-si, Gyeonggi-do (Dongcheon-dong, Bundang Suji U-TOWER)

المقر الأمريكي: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. جميع الحقوق محفوظة.