概覽
合作夥伴 API（B2B）
供擁有合作夥伴入口網站帳號的 B2B 經銷商與合作方在伺服器端讀取 esimoa 商品目錄的 API。
適用對象#
合作夥伴 API 適用於已與 esimoa 簽約並擁有合作夥伴入口網站帳號的 B2B 經銷商、旅行社與企業合作方。您的伺服器可以直接讀取 esimoa 販售中的商品目錄，並據此打造自己的銷售或諮詢工具。
價格（priceKRW）為 esimoa 零售價（韓元），回應中不包含供應商與成本資訊。
提示
如果您經營部落格、比價網站或 AI 服務，請使用任何人皆可註冊並賺取佣金的公開 API。
申請使用#
- 1合作洽詢 — 請先聯絡我們。esimoa 審核後為您建立帳號。
- 2帳號負責人（OWNER）會收到邀請信。連結在 72 小時內僅可使用一次，設定密碼後即可登入。
- 3合作夥伴入口網站 → API 金鑰：核發第一組金鑰。
基礎網址#
url
https://api.esimoa.com/b2b/v1警告
僅限伺服器間呼叫。CORS 不允許來自外部網站的瀏覽器呼叫。請從後端呼叫，切勿將金鑰放入前端或 App 程式碼。
端點#
| 端點 | 說明 |
|---|---|
| GET /b2b/v1/products | 搜尋商品 |
| GET /b2b/v1/products/:id | 單一商品 |
| GET /b2b/v1/countries | 販售國家列表 |
所有端點都要求金鑰具有 catalog:read 權限（預設已授予）。
回應結構#
成功時結果在 data 中，列表還會附帶 total、page 與 limit。失敗時包含 code — message 為英文且可能變動，請依 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." }與公開 API 的比較#
| 合作夥伴 API（B2B） | 公開 API（/v1） | |
|---|---|---|
| 金鑰核發 | 合作夥伴入口網站 | 開發者中心控制台 |
| 分頁 | page (1~) · limit ≤ 50 | offset · limit ≤ 50 |
| 價格欄位 | priceKRW | priceKrw |
| 購買連結 | 無 — 依合約銷售 | url（含合作夥伴代碼） |
| 供應商資訊 | 不包含 | provider |
| 速率限制 | 每組金鑰每分鐘 300 次（可依帳號調整） | 每個夥伴每分鐘 600 次 |