快速入门
简介
将 esimoa eSIM 商品接入您的网站、App 或 AI 助手的 REST API 与 MCP 服务器文档。
可以构建什么#
- 商品搜索 API — 按国家、天数和流量搜索 esimoa eSIM，并在您的网站或 App 中展示实时价格。
- 追踪链接佣金 — API 返回的购买链接都带有您的合作伙伴代码。客户通过该链接付款后即可累计佣金。
- AI 集成（MCP） — 将 esimoa MCP 服务器连接到 ChatGPT、Claude 或 Gemini，AI 即可搜索、比较 eSIM 并给出购买链接。
- 合作伙伴 API（B2B） — 已签约的 B2B 经销商与合作方可以在服务器端获取 esimoa 商品目录，打造自己的销售页面。
应该使用哪个 API#
esimoa 提供两套使用不同密钥的 REST API。大多数网站、博客与 AI 服务使用公开 API 即可。
| 公开 API（/v1） | 合作伙伴 API（B2B） | |
|---|---|---|
| 适用对象 | 推广合作伙伴 — 任何 esimoa 会员 | 已签约的 B2B 经销商与合作方 |
| 密钥签发 | 开发者中心控制台 | 合作伙伴门户 |
| 密钥格式 | esk_live_<32> | esk_live_<10>_<40> |
| 基础地址 | https://api.esimoa.com/v1 | https://api.esimoa.com/b2b/v1 |
| 收益方式 | 通过响应中的追踪链接完成的购买可获佣金 | 依合同约定 |
运作方式#
- 1使用 esimoa 账号登录并填写网站信息，即可立即获得合作伙伴代码。
- 2在控制台创建 API 密钥，密钥仅在创建时显示一次。
- 3在您的服务中展示 API 搜索到的商品及其 url（含合作伙伴代码）。
- 4客户通过该链接付款后佣金即累计，可在控制台查看。