Docs
ศูนย์นักพัฒนาแดชบอร์ดesimoa.com
    • บทนำ
    • เริ่มต้นใช้งานด่วน
    • การยืนยันตัวตน
    • Overview
    • แสดงรายการ eSIM
    • รับ eSIM
    • ประเทศ
    • OpenAPI
    • การติดตามและค่าคอมมิชชัน
    • ขีดจำกัดอัตราคำขอและข้อผิดพลาด
    • Overview
    • รายการ MCP
    • 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 = เฉพาะแพ็กเกจไม่จำกัด
countriesstringทริปหลายประเทศ — รหัสประเทศ 2–8 รหัสคั่นด้วยจุลภาค (เช่น FR,IT,ES) เฉพาะแพ็กเกจที่ใช้ได้ทุกประเทศ
maxDataGbnumberข้อมูลสูงสุด (GB)
minPriceKrw / maxPriceKrwintegerช่วงราคา (KRW)
dataTypestringdaily (ดาต้ารีเซ็ตทุกวัน) | total (ดาต้าก้อนเดียวตลอดระยะเวลา)
localNumberbooleantrue = เฉพาะแพ็กเกจที่มีเบอร์โทรท้องถิ่น (โทร/SMS)
networkstringlocal (เครือข่ายผู้ให้บริการท้องถิ่น) | roaming (เครือข่ายโรมมิ่ง)
multiCountrybooleantrue = เฉพาะแพ็กเกจหลายประเทศ, false = เฉพาะแพ็กเกจประเทศเดียว
providerstringรหัสผู้ให้บริการ — ตามค่าใน provider
hotspot / fiveGbooleanรองรับการแชร์เน็ต / เครือข่าย 5G (โดยประมาณ — ดูกฎด้านล่าง)
sortstringrecommended (ค่าเริ่มต้น) | price (ราคาต่ำสุดก่อน) | data (ข้อมูลมากที่สุดก่อน) | price_per_gb (ราคาต่อ GB ต่ำสุดก่อน) | validity (ระยะเวลานานสุดก่อน)
limitinteger1–50 ค่าเริ่มต้น 10
offsetintegerจำนวนรายการที่ข้าม — ปัดลงเป็นผลคูณของ limit
langstringภาษาของการตอบกลับ — หนึ่งใน ko, en, ja, zh-CN, zh-TW, es, fr, ar, vi, th, id, it, de (ค่าเริ่มต้น en)

Filter rules#

  • days จะใช้แทน minDays และ maxDays
  • unlimited=true จะไม่ใช้ค่า dataGb
  • countries จะใช้แทน country
  • hotspot · fiveG จะตรวจภายใน 50 แพ็กเกจแรกที่ตรงกับตัวกรองอื่น โดยไม่สนใจ offset และการตอบกลับจะมี totalIsApproximate: true
  • ค่าบูลีนรับเฉพาะ true, false, 1 หรือ 0 ค่าอื่นจะได้ 400
  • ผลลัพธ์มีเฉพาะสินค้าที่ 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รหัสสินค้า — ใช้กับ endpoint รายละเอียด
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=) แสดงตามเดิมโดยไม่แก้ไข

หมายเหตุ

ฟิลด์จะมีแต่เพิ่มขึ้นเท่านั้น ชื่อและความหมายจะไม่เปลี่ยน โปรดแยกวิเคราะห์การตอบกลับโดยละเว้นฟิลด์ที่ไม่รู้จัก

อัปเดตล่าสุด: 1 ตุลาคม 2569

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 สงวนลิขสิทธิ์