Overview

API สาธารณะ (/v1)

Shared rules of the /v1 API: base URL, response envelope, pagination and response language.

On this page

URL หลัก
Endpoint
Response envelope
การแบ่งหน้า
Response language
Prices & caching

URL หลัก#

ส่งทุกคำขอผ่าน HTTPS ไปยังที่อยู่ด้านล่าง ต้องใช้คีย์ API สาธารณะ (การยืนยันตัวตน) และทุกการตอบกลับเป็น JSON

url

https://api.esimoa.com/v1

Endpoint#

Endpoint	คำอธิบาย
GET /v1/esims	ค้นหา eSIM
GET /v1/esims/:id	รับ eSIM
GET /v1/countries	แสดงรายการประเทศ
GET /v1/openapi.json	สเปก OpenAPI 3.1 (ไม่ต้องใช้คีย์)

Response envelope#

การตอบกลับที่สำเร็จจะมี "success": true เสมอ รายการจะอยู่ใน items และผลลัพธ์เดี่ยวจะอยู่ใน item

json

// List endpoints
{ "success": true, "items": [ ... ], "total": 42, "limit": 10, "offset": 0, "sort": "price" }

// Detail endpoint
{ "success": true, "item": { ... } }

ดูรูปแบบการตอบกลับข้อผิดพลาดและรหัสสถานะได้ที่ ขีดจำกัดอัตราคำขอและข้อผิดพลาด.

การแบ่งหน้า#

รายการแบ่งหน้าด้วย limit (1–50 ค่าเริ่มต้น 10) และ offset โดย offset จะถูกปัดลงเป็นผลคูณของ limit เสมอ — เช่น limit=10, offset=15 จะถือเป็น offset=10 ค่า offset ในการตอบกลับคือค่าที่ใช้จริง และ total คือจำนวนทั้งหมด

ทิป

ขอหน้าถัดไปด้วย offset + limit ค่า offset ที่ไม่ใช่ผลคูณของ limit อาจทำให้รายการซ้ำข้ามหน้า จึงถูกปัดลง

Response language#

พารามิเตอร์ lang (ko | en | ja | zh-CN | zh-TW, ค่าเริ่มต้น en) กำหนดภาษาของชื่อประเทศ ชื่อสินค้า และหน้าซื้อที่ url ชี้ไป ควรตั้งให้ตรงกับภาษาของผู้ใช้

Prices & caching#

ราคา (priceKrw) คือราคาขายของ esimoa เป็น KRW แบบจำนวนเต็ม ราคาเปลี่ยนบ่อย — แคชผลการค้นหาไม่เกินไม่กี่นาที หน้าชำระเงินของ esimoa คือแหล่งอ้างอิงจริงของยอดที่เรียกเก็บเสมอ