Overview
API đối tác (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 dành cho đại lý B2B, công ty du lịch và đối tác doanh nghiệp đã ký hợp đồng với esimoa và có tài khoản cổng đối tác. Máy chủ của bạn có thể đọc cùng danh mục sản phẩm mà esimoa đang bán và xây dựng công cụ bán hàng hoặc hỗ trợ riêng trên đó.
Giá (priceKRW) là giá bán lẻ của esimoa tính bằng KRW. Phản hồi không bao giờ chứa thông tin nhà cung cấp hoặc giá vốn.
Tiền boa
Getting access#
- 1Yêu cầu hợp tác — hãy liên hệ với chúng tôi trước. esimoa sẽ xem xét yêu cầu và tạo tài khoản cho bạn.
- 2Chủ tài khoản (OWNER) sẽ nhận email mời. Liên kết chỉ dùng được một lần trong vòng 72 giờ; đặt mật khẩu là bạn sẽ được đăng nhập.
- 3Cổng đối tác → Khóa API: tạo khóa đầu tiên của bạn.
URL cơ sở#
https://api.esimoa.com/b2b/v1Cảnh báo
Endpoint#
| Endpoint | Mô tả |
|---|---|
| GET /b2b/v1/products | Tìm sản phẩm |
| GET /b2b/v1/products/:id | Một sản phẩm |
| GET /b2b/v1/countries | Quốc gia có sản phẩm |
Mọi endpoint đều yêu cầu catalog:read trong phạm vi của khóa (được cấp mặc định).
Response envelope#
Khi thành công, kết quả nằm trong data, và danh sách còn có total, page và limit. Lỗi có kèm code — thông báo bằng tiếng Anh và có thể thay đổi, vì vậy hãy phân nhánh theo code.
// 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 đối tác (B2B) | API công khai (/v1) | |
|---|---|---|
| Cấp khóa | Cổng đối tác | Bảng điều khiển Trung tâm nhà phát triển |
| Phân trang | page (1~) · limit ≤ 50 | offset · limit ≤ 50 |
| Trường giá | priceKRW | priceKrw |
| Liên kết mua hàng | Không có — doanh số theo hợp đồng của bạn | url (kèm mã đối tác) |
| Thông tin nhà cung cấp | Không bao gồm | provider |
| Giới hạn tần suất | 300/phút mỗi khóa (có thể điều chỉnh theo tài khoản) | 600/phút mỗi đối tác |