TripoSIM
开发者 API

数小时内将 eSIM 集成到您的产品,而非数月

RESTful API。OAuth2。沙盒环境。Webhook。179+ 目的地。由 22+ 年电信经验支撑的企业级基础设施。

200+
目的地
99.9%
可用性 SLA
< 3s
开通时间
5
聚合供应商数
API 功能

由开发者为开发者打造

所有您需要的功能,助力您可靠、安全地将 eSIM 开通集成到产品中。

OAuth2 身份验证

行业标准 client_credentials 流程。访问令牌 15 分钟后过期,由我们的 SDK 自动刷新。

沙盒模式

上线前使用模拟数据进行测试,不扣除钱包余额,不开通真实 eSIM。提供独立的沙盒 API 密钥。

Webhook 通知

使用 HMAC-SHA256 签名的 Webhook,支持指数退避重试。6 种事件类型:order.completed、esim.activated、usage.threshold 等。

试运行订单

在不扣费的情况下验证订单,适用于 UI 预览、可用性检查和承诺前的价格估算。

幂等性密钥

防止网络重试导致的重复扣费。所有创建接口均支持幂等性密钥,24 小时内去重。

多供应商路由

5 家上游 eSIM 供应商聚合于单一 API 之后,自动故障转移确保 99.9% 的开通成功率。

集成流程

五步完成首张 eSIM 开通

1

获取 API 密钥

在 partners.triposim.com 注册,通过审核后,在开发者看板中生成沙盒 API 密钥。

2

身份验证

通过 /v1/auth/token 接口,使用您的客户端凭证换取 15 分钟有效的访问令牌。

3

浏览目录

通过 /v1/packages 接口,按国家、类型和价格筛选,查找可用的 eSIM 套餐。

4

下单

向 /v1/orders 发送 POST 请求,包含套餐 ID 和数量,响应中即可获取 ICCID 和二维码。

5

交付给用户

在您的应用中展示二维码或通过邮件发送,客户扫码即可安装 eSIM。

代码示例

用您熟悉的语言快速上手

# 1. Get access token
curl -X POST https://api.triposim.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'

# 2. Order an eSIM
curl -X POST https://api.triposim.com/v1/orders \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{
    "package_id": "turkey-5gb-30d",
    "quantity": 1
  }'
接口列表

API 参考概览

简洁、可预测的 REST API。完整文档请访问 docs.triposim.com。

方法接口描述
POST/v1/auth/token获取访问令牌
GET/v1/packages浏览 eSIM 目录
GET/v1/packages/{id}获取套餐详情
POST/v1/orders创建订单(开通 eSIM)
GET/v1/orders查看订单列表
GET/v1/orders/{id}获取订单详情
GET/v1/esims/{iccid}eSIM 状态与详情
GET/v1/esims/{iccid}/usage实时数据用量
GET/v1/account/balance钱包余额
POST/v1/webhooks注册 Webhook 接口
GET/v1/healthAPI 健康检查
应用场景

适用于各类旅行平台

金融科技超级应用

在旅行板块中加入 eSIM,与机票、酒店和保险并列。为用户提供一键数据连接服务。

航空公司

在订票流程中提供目的地 eSIM。乘客落地时设备上已提前开通数据。

旅行平台

将 eSIM 与机票和酒店捆绑销售,以零库存、高利润的附加服务提升平均订单金额。

MVNO

以您的品牌提供白标 eSIM 服务,完全通过 API 控制开通、品牌和客户体验。

企业差旅工具

自动化员工网络连接,根据行程开通 eSIM,集中追踪用量并管理报销。

企业级

面向大型合作伙伴的企业级方案

每月处理数千张 eSIM?我们的企业版专为规模化和高可靠性而构建。

专属支持

与我们工程团队建立专属 Slack/Teams 频道,工作时间内 2 小时内保证响应。

自定义限速配置

每天需处理超过 500 笔订单?企业版支持根据您的需求定制吞吐量上限。

基于量的定价

分级批发定价,随量增长单价递减。每月超过 1,000 笔订单,请联系我们获取定制报价。

SLA 保障

99.9% 可用性 SLA,任何停机均提供财务赔偿。开通成功率保证达到 99.5% 或以上。

品牌定制邮件

即将推出:使用您自己的域名和公司品牌发送二维码交付邮件。

优先路由

企业 API 合作伙伴在高需求时段优先获取供应商库存。

常见问题

常见问题解答

开始使用 TripoSIM API 构建应用

从沙盒到生产,数小时内完成。179+ 目的地,5 家上游供应商,一套简单的 API。

由 BroadNet Technologies 提供支持——22+ 年电信行业经验,运营商级基础设施