Skip to content
TripoSIM
開發者 API

數小時內將 eSIM 整合到您的產品,而非數月

RESTful API。 OAuth2。沙盒環境。 Webhook。 200+ 目的地。由 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 建置應用

從沙盒到生產,數小時內完成。 200+ 目的地,5 家上游供應商,一套簡單的 API。

由 BroadNet Technologies 提供支援-22+ 年電信業經驗,營運商級基礎設施