Overview
API สำหรับพาร์ตเนอร์ (B2B)
A server-to-server API for B2B resellers and partners with a partner portal account to read the esimoa product catalog.
Who it is for#
Partner API มีไว้สำหรับผู้ค้าปลีก B2B บริษัททัวร์ และพาร์ตเนอร์องค์กรที่ทำสัญญากับ esimoa และมีบัญชีพอร์ทัลพาร์ตเนอร์ เซิร์ฟเวอร์ของคุณสามารถอ่านแคตตาล็อกสินค้าเดียวกับที่ esimoa ขาย และสร้างเครื่องมือขายหรือบริการลูกค้าของคุณเองต่อยอดได้
ราคา (priceKRW) คือราคาขายปลีกของ esimoa เป็น KRW การตอบกลับจะไม่มีข้อมูลผู้จำหน่ายหรือต้นทุน
ทิป
ทำบล็อก เว็บเปรียบเทียบ หรือผลิตภัณฑ์ AI อยู่ใช่ไหม? API สาธารณะ เปิดให้ทุกคนเข้าร่วมและรับค่าคอมมิชชันได้
Getting access#
- 1ติดต่อความร่วมมือ — ติดต่อเราก่อน esimoa จะตรวจสอบคำขอและสร้างบัญชีให้คุณ
- 2เจ้าของบัญชี (OWNER) จะได้รับอีเมลเชิญ ลิงก์ใช้ได้ครั้งเดียวภายใน 72 ชั่วโมง เมื่อตั้งรหัสผ่านแล้วจะเข้าสู่ระบบทันที
- 3พอร์ทัลพาร์ตเนอร์ → คีย์ API: สร้างคีย์แรกของคุณ
URL หลัก#
url
https://api.esimoa.com/b2b/v1คำเตือน
เรียกใช้ API นี้จากแบ็กเอนด์ของคุณ CORS ไม่อนุญาตให้เบราว์เซอร์จากเว็บไซต์ภายนอกเรียกใช้ ห้ามใส่คีย์ไว้ในโค้ดฝั่งฟรอนต์เอนด์หรือแอปเด็ดขาด
Endpoint#
| Endpoint | คำอธิบาย |
|---|---|
| GET /b2b/v1/products | ค้นหาสินค้า |
| GET /b2b/v1/products/:id | สินค้าหนึ่งรายการ |
| GET /b2b/v1/countries | ประเทศที่มีสินค้า |
ทุก endpoint ต้องมี 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/นาทีต่อพาร์ตเนอร์ |