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订单，获取二维码和激活详情，或为现有套餐充值。
  • 管理eSIM生命周期 — 检查状态和数据使用量，暂停、取消或激活线路，并查看网络事件或发送短信。
  • 通过webhooks监控 — 设置端点以实时接收订单和生命周期事件的通知，无需轮询。

文档

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

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

谁在使用 eSIM API 进行开发

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

旅行应用与 OTA

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

经销商与 MVNO

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

IoT 与车队平台

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

超级应用与金融科技

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

API 能力

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

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

目录与定价

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

获取全部套餐余额查询

订单与充值

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

创建订单充值套餐与订单

eSIM 生命周期

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

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

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？+

支持。Webhooks 会在异步配置的 eSIM 就绪时通知您——某些运营商（如日本 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 服务器 https://mcp.esimfly.net/mcp 添加到 Claude、ChatGPT 或 Cursor，并使用您的企业账户登录——无需粘贴密钥。搜索套餐、检查用量并针对实时 API 诊断 eSIM；默认只读，任何下单前都有确认步骤。更喜欢本地部署？npx -y @esimfly/mcp。

集成教程

可运行的 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 集成到您的产品中了吗？

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