API العامة (/v1)
عرض قائمة شرائح eSIM
GET /v1/esims — search eSIMs by country, duration and data, and get purchase URLs that carry your partner code.
Request#
GET
/v1/esimscurl "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#
جميع المعلمات اختيارية.
| المعامل | النوع | الوصف |
|---|---|---|
country | string | رمز البلد (ISO 3166-1 alpha-2، مثل JP) |
days | integer | مدة الصلاحية بالأيام بالضبط |
minDays | integer | الحد الأدنى للصلاحية (بالأيام) |
maxDays | integer | الحد الأقصى للصلاحية (بالأيام) |
dataGb | number | الحد الأدنى للبيانات (GB) |
unlimited | boolean | true = الباقات غير المحدودة فقط |
sort | string | recommended (افتراضي) | price (الأقل سعرًا أولًا) | data (الأكثر بيانات أولًا) |
limit | integer | 1–50، الافتراضي 10 |
offset | integer | عدد العناصر المراد تخطيها — يُقرَّب للأسفل إلى مضاعف limit |
lang | string | لغة الاستجابة: 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#
| الحقل | النوع | الوصف |
|---|---|---|
id | string | معرّف المنتج — استخدمه مع نقطة نهاية التفاصيل |
title | string | الاسم المعروض (بلغة lang) |
countryCode / countryName | string | null | البلد الرئيسي (null للباقات متعددة البلدان) |
coverageCountries | string[] | رموز البلدان التي تعمل فيها eSIM |
isMultiCountry | boolean | باقة متعددة البلدان |
dataAmount / dataAmountGB | string / number | حجم البيانات (تسمية / رقم بالـ GB) |
isUnlimited | boolean | باقة غير محدودة |
dataType | 'total' | 'daily' | null | إجمالي الحصة أو الحصة اليومية |
validityDays | integer | الصلاحية بالأيام |
priceKrw / currency | integer / 'KRW' | السعر بـ KRW |
provider / networkType | string | المزوّد / الشبكة (مثل 5G) |
hotspot / hasLocalNumber / isLocalNetwork | boolean | مشاركة الإنترنت / رقم هاتف محلي / شبكة محلية |
url | string | رابط شراء يتضمن رمز الشريك الخاص بك (?ref=). اعرضه كما هو. |
ملاحظة
تُضاف الحقول فقط، ولا تتغير أسماؤها ومعانيها أبدًا. حلّل الاستجابات بحيث يتم تجاهل الحقول غير المعروفة.
