數小時內將 eSIM 整合到您的產品,而非數月
RESTful API。 OAuth2。沙盒環境。 Webhook。 200+ 目的地。由 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 建置應用
從沙盒到生產,數小時內完成。 200+ 目的地,5 家上游供應商,一套簡單的 API。
由 BroadNet Technologies 提供支援-22+ 年電信業經驗,營運商級基礎設施