eSIMfly MCP

官方

搜尋200多個國家的批發eSIM數據方案，查詢餘額與使用量，從即時網路資料診斷eSIM連線，並（可選，需確認步驟）訂購及加值eSIM——這是eSIMfly Business API的官方MCP伺服器。預設為唯讀。安裝：npx -y @esimfly/mcp — 來源：github.com/eSimfly-Official/esimfly-mcp

造訪 esimfly.net

你可以用 eSIMfly MCP 做什麼？

  • 瀏覽批發 eSIM 目錄 — 查詢 200 多個國家的可用數據方案與批發價格，以及您的帳戶餘額。
  • 訂購並開通 eSIM — 請求新的 eSIM 訂單，包含 QR code 與啟用詳情，或為現有方案加值。
  • 管理 eSIM 生命週期 — 檢查狀態與數據使用量、暫停、取消或啟用線路，並查看網路事件或發送簡訊。
  • 透過 Webhook 監控 — 設定端點以即時接收訂單與生命週期事件的通知，無需輪詢。

文件

給開發者的 eSIM API：在您自己的產品中銷售 eSIM

透過一個 REST API，將涵蓋 200 個國家的批發 eSIM 數據方案整合到您的應用程式、平台或商店中——包括目錄、訂購、加值、用量查詢與完整的生命週期管理。

誰在使用 eSIM API 開發

企業透過批發 eSIM 整合，為其現有產品增加連線服務營收。

旅遊應用程式與 OTA

在預訂時提供 eSIM 加購選項。您的旅客一落地即可連網，而您能從每筆銷售的方案中賺取利潤。

經銷商與 MVNO

以批發價取得 eSIM，並透過您自己的通路銷售，自訂價格與包裝。

IoT 與車隊平台

透過單一整合，跨國部署並監控裝置與車輛的連線狀態。

超級應用程式與金融科技

在支付、銀行或會員服務旁，將國際數據方案作為原生功能加入。

API 功能

以程式化方式營運 eSIM 所需的一切

此 API 涵蓋從瀏覽批發方案到管理實際運作中 eSIM 的完整流程。

目錄與定價

瀏覽所有可用的數據方案，查看 200 個國家的批發價格，並在訂購前確認帳戶餘額。

取得所有方案餘額查詢

訂單與加值

立即開通新的 eSIM，並為既有 eSIM 加值。訂單會回傳 QR code 與啟用資訊，可直接交付給您的使用者。

建立訂單加值方案與訂單

eSIM 生命週期

管理您發出的每一張 eSIM：查詢狀態與數據用量、暫停或取消線路、檢視網路事件，以及發送簡訊。

查詢 eSIMeSIM 狀態取消／暫停／啟用用量報告網路事件發送簡訊

Webhook

註冊端點以接收訂單與 eSIM 生命週期事件的即時通知——無需輪詢。

Webhook 管理事件通知

批發 eSIM 費率，您的利潤

API 合作夥伴以批發價購買數據方案，並自行設定零售價格。目錄涵蓋 200 個國家、450 多個網路的本地、區域與全球方案，因此單一整合即可涵蓋您使用者前往的所有目的地。餘額制計費簡化了結算流程：為您的帳戶儲值，每筆訂單即依您的批發費率從中扣款。

如果您想要現成的商店，而非自行開發，我們的白標 eSIM 經銷商平台在同一基礎架構上提供品牌網站、儀表板與行動應用程式。

安全設計：HMAC 簽章請求

每個 API 呼叫皆以 HMAC-SHA256 簽章進行驗證，簽章涵蓋請求時間戳記、唯一請求 ID、您的存取碼與請求內文——提供完整性驗證與重放攻擊防護。Node.js、Python 與 PHP 的現成簽章範例位於文件中。

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

三個步驟取得 API 存取權

1. 建立商業帳戶

註冊 eSIMfly 商業帳戶，並告訴我們您的使用情境與預期用量。

2. 產生您的 API 金鑰

從商業儀表板建立與管理存取憑證，然後為您的餘額儲值。

3. 整合並上線

依照文件瀏覽方案、下測試訂單，並可選擇註冊 webhook 以接收非同步開通的 eSIM 通知。

常見問題

eSIM API 常見問題解答

什麼是 eSIMfly eSIM API？+

eSIMfly API 是一個 REST API，讓您能以批發價以程式化方式購買、開通與管理 eSIM。您可以從自己的應用程式中瀏覽方案目錄、建立訂單、加值方案、監控用量，並管理完整的 eSIM 生命週期（啟用、暫停、取消），涵蓋 200 個國家、450 多個網路。

eSIM API 適合誰使用？+

此 API 專為想將 eSIM 連線服務嵌入自家產品的公司而設計：旅遊應用程式與預訂平台、電信經銷商與 MVNO、IoT 與車隊平台，以及任何想為使用者提供國際數據、卻不想自行建立電信合作關係的服務。

API 驗證如何運作？+

請求以 HMAC-SHA256 簽章進行驗證。每個請求都帶有存取碼、唯一請求 ID、時間戳記，以及使用您的密鑰計算的簽章，提供請求完整性驗證並防止重放攻擊。Node.js、Python 與 PHP 的程式碼範例可在文件中取得。

我如何取得 eSIM API 存取權？+

建立 eSIMfly 商業帳戶，然後從商業儀表板產生 API 金鑰。批發價格等級取決於用量——請聯絡我們的銷售團隊，討論您預期訂單量的費率。

API 支援 webhook 嗎？+

支援。當非同步開通的 eSIM 準備就緒時，webhook 會通知您——某些電信商（如 KDDI Japan）需要幾分鐘時間，而您會收到帶有 eSIM 詳細資訊的簽章 POST，無需輪詢。大多數供應商會在訂單回應中同步開通，狀態與用量則可透過狀態與用量端點查詢。

API 的速率限制為何？+

此 API 每個帳戶每小時允許 1,000 次請求。超過 5 分鐘的請求會因重放攻擊防護而被拒絕。如果您的整合需要更高的限制，請聯絡銷售團隊。

官方 SDK · NODE.JS / TYPESCRIPT

跳過簽章程式碼——直接安裝 SDK

npm install @esimfly/sdk 提供整個 API 的型別化存取——HMAC 簽章、全新請求 ID、冪等訂單、節奏化目錄同步與 webhook 簽章驗證皆已內建。零依賴、Node.js 18+、MIT 授權且開放原始碼。PHP 與 Python SDK 即將推出。

使用 AI 代理？將託管的 MCP server https://mcp.esimfly.net/mcp 加入 Claude、ChatGPT 或 Cursor，並以您的商業帳戶登入——無需貼上金鑰。搜尋方案、查詢用量並針對即時 API 診斷 eSIM；預設為唯讀，任何訂單前皆有確認步驟。偏好本機？npx -y @esimfly/mcp。

整合教學

可運作的 Node.js 程式碼，從第一個請求到正式環境的 webhook。

[

從這裡開始 · 架構指南

eSIM API 整合指南

四大組成要素、簽章驗證、同步 vs webhook 開通、供應商評估清單，以及只有在正式環境才會出現的陷阱。

閱讀指南](https://esimfly.net/esim-api/integration-guide)

[

第 1 部分 · 約 30 分鐘

使用 Node.js 在您的應用程式中銷售 eSIM

HMAC 驗證、方案目錄、訂單建立與 QR code 交付——一個完整可運作的商店。

開始教學](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

第 2 部分 · 生命週期

加值、用量追蹤與 Webhook

即時用量查詢、既有 eSIM 的加值銷售，以及無需輪詢的簽章 webhook。

繼續第 2 部分](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

準備好將 eSIM 整合到您的產品中了嗎？

從文件開始，或與我們的團隊討論您用量的批發費率。