概览
合作伙伴 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 次 |