数小时内将 eSIM 集成到您的产品,而非数月
RESTful API。OAuth2。沙盒环境。Webhook。179+ 目的地。由 22+ 年电信经验支撑的企业级基础设施。
curl -X POST https://api.triposim.com/v1/orders \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{
"package_id": "turkey-5gb-30d",
"quantity": 1
}'{
"id": "ord_abc123",
"status": "completed",
"esims": [{
"iccid": "8901234567890",
"qr_code": "LPA:1$smdp..."
}]
}由开发者为开发者打造
所有您需要的功能,助力您可靠、安全地将 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 开通
获取 API 密钥
在 partners.triposim.com 注册,通过审核后,在开发者看板中生成沙盒 API 密钥。
身份验证
通过 /v1/auth/token 接口,使用您的客户端凭证换取 15 分钟有效的访问令牌。
浏览目录
通过 /v1/packages 接口,按国家、类型和价格筛选,查找可用的 eSIM 套餐。
下单
向 /v1/orders 发送 POST 请求,包含套餐 ID 和数量,响应中即可获取 ICCID 和二维码。
交付给用户
在您的应用中展示二维码或通过邮件发送,客户扫码即可安装 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/health | API 健康检查 |
适用于各类旅行平台
金融科技超级应用
在旅行板块中加入 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+ 年电信行业经验,运营商级基础设施