eSIMfly MCP

官方

搜索200多个国家的批发eSIM数据套餐，查询余额和使用情况，从实时网络数据诊断eSIM连接问题，并可（可选，需确认步骤）订购和充值eSIM——这是eSIMfly Business API的官方MCP服务器。默认只读。安装：npx -y @esimfly/mcp — 来源：github.com/eSimfly-Official/esimfly-mcp

访问 esimfly.net试用此 MCP赞助

你可以用 eSIMfly MCP 做什么？

  • 搜索 eSIM 套餐 — 让您的助手浏览批发目录，并使用 get_all_packages 比较 200 个国家/地区的数据套餐。
  • 查询账户余额 — 在下单前，让您的助手通过 balance_query 端点查询当前余额。
  • 创建 eSIM 订单 — 指示您的助手通过 create_order 开通新的 eSIM，并返回二维码/激活详情。
  • 为现有 eSIM 充值 — 让您的助手使用 topup_packages_and_orders 操作为有效套餐添加数据。
  • 管理 eSIM 生命周期 — 指示您的助手通过 esim_status 及相关端点检查状态、监控用量、暂停或取消线路。
  • 配置 Webhook — 让您的助手通过 webhook_management 注册端点，以接收订单和生命周期事件的实时通知。

文档

面向开发者的 eSIM API：在您自己的产品中销售 eSIM

通过一个 REST API 将覆盖 200 个国家的批发 eSIM 数据套餐集成到您的应用、平台或商店中——包括目录、订购、充值、用量和完整的生命周期管理。

谁在使用 eSIM API 进行开发

企业通过批发 eSIM 集成，为其现有产品增加连接收入。

旅行应用与 OTA

在预订时提供 eSIM 追加销售。您的旅客落地即可联网，而您从每笔售出的套餐中保留利润。

经销商与 MVNO

以批发价采购 eSIM，并通过您自己的渠道销售，使用您自己的定价和包装。

IoT 与车队平台

通过单一集成，为跨境设备和车辆进行连接配置与监控。

超级应用与金融科技

将国际数据套餐作为原生功能，与支付、银行或忠诚度产品并列提供。

API 能力

以编程方式运营 eSIM 所需的一切

该 API 覆盖从浏览批发套餐到管理现场活跃 eSIM 的完整流程。

目录与定价

浏览所有可用数据套餐及其覆盖 200 个国家的批发价格，并在下单前查询账户余额。

获取全部套餐余额查询

订单与充值

即时开通新 eSIM 并为现有 eSIM 充值。订单返回二维码和激活详情，可直接交付给您的用户。

创建订单充值套餐与订单

eSIM 生命周期

管理您发行的每一张 eSIM：查看状态和数据用量、暂停或取消线路、查看网络事件以及发送短信。

查询 eSIMeSIM 状态取消 / 暂停 / 激活用量报告网络事件发送短信

Webhooks

注册端点以接收订单和 eSIM 生命周期事件的实时通知——无需轮询。

Webhook 管理事件通知

批发 eSIM 价格，您的利润

API 合作伙伴以批发价购买数据套餐，并自行设定零售价格。目录涵盖 200 个国家、450+ 网络的本地、区域和全球套餐，因此一次集成即可覆盖您的用户前往的所有目的地。余额计费让结算变得简单：为您的账户充值，每笔订单按您的批发价从中扣款。

如果您希望拥有现成的商店前端而不是自行构建，我们的 白标 eSIM 平台 在同一基础设施之上提供品牌网站、仪表盘和移动应用。

安全设计：HMAC 签名请求

每个 API 调用均通过基于请求时间戳、唯一请求 ID、您的访问代码和请求正文的 HMAC-SHA256 签名进行身份验证——提供完整性校验和重放攻击防护。文档中提供了 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. 集成并上线

按照文档浏览套餐、下测试订单，并可选择为异步开通的 eSIM 注册 webhook。

常见问题

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 是否支持 webhooks？+

支持。当异步开通的 eSIM 就绪时，webhooks 会通知您——某些运营商（如日本 KDDI）需要几分钟时间，您无需轮询，而是会收到一个包含 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 服务器（npx -y @esimfly/mcp）让 Claude、Cursor 或 ChatGPT 能够搜索套餐、检查用量并针对实时 API 诊断 eSIM——默认只读，任何下单前都有确认步骤。

集成教程

可运行的 Node.js 代码，从第一个请求到生产级 webhooks。

[

从这里开始 · 架构指南

eSIM API 集成指南

四大构建模块、签名身份验证、同步与 webhook 开通、提供商评估清单，以及只有在生产环境中才会暴露的陷阱。

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

[

第 1 部分 · 约 30 分钟

使用 Node.js 在您的应用中销售 eSIM

HMAC 身份验证、套餐目录、订单创建和二维码交付——一个完整可用的商店前端。

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

第 2 部分 · 生命周期

充值、用量跟踪与 Webhooks

实时用量查询、对现有 eSIM 的充值销售，以及无需轮询的签名 webhooks。

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

准备好将 eSIM 集成到您的产品中了吗？

从文档开始，或与我们的团队讨论适合您用量的批发费率。