快速入門
簡介
將 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客戶透過該連結付款後佣金即累積，可在控制台查看。