eSimfly Logo
API DE ESIM Y MAYORISTA

面向开发者的 eSIM API:在您自己的产品里卖 eSIM

用一套 REST API,把覆盖 200 个国家的批发级 eSIM 流量套餐接入您的 App、平台或商城: 目录、下单、续费、用量与完整的生命周期管理。

谁在用这套 eSIM API

企业通过接入批发级 eSIM,为现有产品增加一块联网业务的收入。

旅行 App 与 OTA

在预订环节把 eSIM 作为加购项推荐。旅客一落地就有网,每卖出一个套餐您都拿到差价。

分销商与虚拟运营商

按批发价采购 eSIM,用自己的渠道、自己的定价和包装去销售。

物联网与车队平台

一次集成,即可跨境开通并监控设备与车辆的联网状态。

超级 App 与金融科技

把国际流量套餐做成原生功能,与支付、银行或会员权益并列。

CAPACIDADES DE LA API

以编程方式管理 eSIM 所需要的一切

这套 API 覆盖全流程:从查询批发套餐,到管理已经在外面使用中的 eSIM。

目录与价格

查询 200 个国家全部在售流量套餐的批发价,并在下单前确认账户余额。

Get All PackagesBalance Query

下单与续费

即时开通新的 eSIM,也可为已有的 eSIM 续费。下单接口会返回二维码与激活信息,可直接交付给您的用户。

Create OrderTopup Packages & Orders

eSIM 生命周期

管理您签发的所有 eSIM:查询状态与流量用量、暂停或注销线路、查看网络事件、发送短信。

List / Query eSIMseSIM StatusCancel / Suspend / ActivateUsage ReportNetwork EventsSend SMS

Webhook

注册回调地址,实时接收订单与 eSIM 生命周期事件的通知,不必反复轮询。

Webhook ManagementEvent Notifications

批发价拿货,差价归您

API 合作伙伴按批发价采购流量套餐,并自行决定零售价。 目录涵盖 200 个国家、450 多张网络的本地、区域与全球套餐,一次集成就能覆盖用户所有的目的地。 结算采用余额方式,非常简单:为账户充值,每笔订单按您的批发价从余额中扣除。

如果您不想自己从零搭建,更希望直接拿到一个完整的商城,我们的 白牌 eSIM 平台 提供带您自有品牌的网站、后台与移动 App,底层用的是同一套基础设施。

安全内建:所有请求均带 HMAC 签名

每一次 API 调用都通过 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。

PREGUNTAS FRECUENTES

关于这套 eSIM API 的常见问题

eSIMfly 的 eSIM API 是什么?+

eSIMfly API 是一套 REST 接口,让您以编程方式按批发价购买、开通和管理 eSIM。您可以查询套餐目录、创建订单、为套餐续费、监控用量,并在自己的应用里管理 eSIM 的完整生命周期(激活、暂停、注销),覆盖 200 个国家、450 多张网络。

这套 eSIM API 适合谁用?+

这套 API 面向希望把 eSIM 联网能力集成进自家产品的企业:旅行 App 与预订平台、电信分销商与虚拟运营商、物联网与车队管理平台,以及任何想给用户提供国际流量、又不想逐一去和运营商谈判的服务。

API 的鉴权是怎么做的?+

请求通过 HMAC-SHA256 签名进行鉴权。每个请求都包含访问码、唯一的请求标识、时间戳,以及用您的密钥计算出的签名,以此保证请求的完整性并防止重放攻击。文档中提供 Node.js、Python 与 PHP 的示例代码。

怎么获得 API 权限?+

在 eSIMfly 注册企业账户,然后在企业后台生成 API 密钥。批发价分档取决于业务量:请联系我们的商务团队,按您预计的订单量了解具体价格。

API 支持 Webhook 吗?+

支持。当一张异步开通的 eSIM 准备就绪时,Webhook 会通知您:个别运营商(例如日本的 KDDI)需要等几分钟,这时您不必反复轮询,而是会收到一个带签名的 POST,里面包含 eSIM 的数据。多数供应方会在下单响应中同步开通;状态与用量则通过相应的接口查询。

API 的请求频率限制是多少?+

每个账户每小时 1000 次请求。超过 5 分钟的旧请求会被拒绝,这是防重放机制的一部分。如果您的集成需要更高的限额,请联系商务团队。

SDK OFICIAL · 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.

准备好把 eSIM 集成进您的产品了吗?

可以先看文档,也可以直接联系我们的团队,按您的业务量谈批发价。