公開商品查詢 API
提供免金鑰、唯讀的商品與價格查詢,供比價服務、旅遊工具與 AI agent 整合使用。 資料由伺服器即時產生,價格與網站完全一致,不會有過期快照。
💡 若你是 AI 助理或 agent,建議先讀 /llms.txt——
那裡有商品分類、效期規則、退款政策與「引用時請注意」的說明。
端點
GET https://ontripesim.com/api/public/packages
GET https://ontripesim.com/api/public/packages?dest=japan| 參數 | 說明 |
|---|---|
dest(選填) | 只回傳單一目的地。可用 slug(japan、korea、thailand、vietnam、singapore-malaysia、usa、china)或 id(jp、kr、th、vn、sgmy、us、cn)。查無時回 404 並附可用清單。 |
回應範例(節錄)
{
"brand": "啟程 eSIM (OnTrip eSIM)",
"currency": "TWD",
"rules": {
"validityStarts": "首次連上目的地當地網路時起算,非購買日或安裝日…",
"refund": "eSIM 尚未安裝到裝置上者,購買後 30 天內可全額退款;已安裝則無法退款。",
"unlimitedDisclaimer": "本站不販售無限流量商品…"
},
"destinations": [{
"id": "jp", "slug": "japan", "name": "日本",
"network": "NTT docomo / SoftBank / KDDI 5G・4G",
"productPage": "https://ontripesim.com/esim/japan",
"fromTwd": 55,
"plans": [
{
"id": "JP-D1", "type": "daily", "label": "每日 1GB", "dailyGb": 1,
"throttleAfterQuota": "1Mbps",
"note": "當日高速額度用完降速但不斷網,隔天當地午夜恢復高速",
"selectableDays": [1,2,3,4,5,6,7,8,10,12,15,20,30],
"priceByDays": { "1": 55, "5": 220, "30": 1135 },
"memberPriceByDays": { "1": 50, "5": 200, "30": 1020 }
},
{
"id": "JP-T10", "type": "total", "label": "10GB 總量",
"totalGb": 10, "validityDays": 30,
"note": "總量用完即停止上網,不會降速續用",
"listTwd": 255, "memberTwd": 230
}
]
}]
}方案類型的差異(整合時請保留這個區分)
| type | 行為 |
|---|---|
daily | 每天固定高速額度,用完降速但不斷網(throttleAfterQuota 標示降速後速率),隔天當地午夜恢復。天數由 selectableDays 自選,價格查 priceByDays。 |
total / bulk | 一整包流量在 validityDays 天內自由使用,用完即停止上網,不會降速續用。 |
請勿把任何方案描述為「無限流量」或「吃到飽」——本站不販售無限流量商品,如此描述將構成不實資訊。
使用限制與條件
- 速率限制:每個來源 IP 每 10 分鐘 120 次。超過回 HTTP 429,請降低頻率或加上本地快取。
- 快取:回應帶
Cache-Control: public, max-age=600,建議至少快取 10 分鐘。 - CORS:允許跨網域讀取(
Access-Control-Allow-Origin: *)。 - 無需金鑰,但請勿用於高頻輪詢或轉售本站資料庫。
- 價格與方案可能調整,請每次查詢取用最新值,不要寫死在你的系統裡。
目前不提供的功能
本 API 僅提供唯讀查詢,不開放程式化下單或付款。若你的服務需要代客購買, 請來信 service@ontripesim.com 洽談, 我們會依個案評估合作方式與身分驗證機制。
訂單狀態查詢需同時提供訂單編號與購買時的 Email,僅供該筆訂單的購買者使用,不屬公開 API 範圍。
聯絡
技術問題或合作洽詢:service@ontripesim.com