Roamify eSIM API 重大變更

我們正在推出一系列 API 更新，帶來新的端點、擴展的功能，以及在更新整合之前您需要注意的一些變更。

⚠️ 重大變更 — 獲取 eSIM 套餐 #

端點： GET /api/esim/packages

https://roamify.apidog.io/get-esim-packages-12947634e0

1. 回應現在是分頁的 #

此端點現在返回 分頁結果 而不是在單一回應中返回所有套件。如果您的整合在沒有分頁參數的情況下獲取套件，您可能只會收到第一頁的結果。

需要採取行動： 更新您的整合以使用 page 和 pageSize 查詢參數處理分頁回應。

要檢索所有套餐，請迭代頁面，直到回應返回的結果少於您的 頁面大小.

2. 國家 和 countryCode 現在有不同的含義 #

之前這些字段可能可以互換使用。它們現在有不同的用途，並且 兩者必須使用來自 GET /api/esim/countries 端點的值 — 不再接受任意字符串。

需要採取行動： 如果您目前正在傳遞自由文本國家字串，請更新您的整合，首先呼叫 GET /api/esim/countries 並使用 name 或 code 值來自回應。

新端點 #

GET /api/esim/countries #

https://roamify.apidog.io/get-esim-supported-country-12947635e0

返回 Roamify eSIM 支援的所有國家的列表。使用 name 和 代碼 從此響應中作為查詢的過濾輸入值 GET /api/esim/packages.

可選的過濾參數可用於 地理位置

POST /api/esim/sms #

https://roamify.apidog.io/send-sms-37579804e0

直接向 eSIM 發送 SMS 訊息。

更新的端點 #

POST /api/esim/apply — 開始日期 現在支援 #

已新增一個可選的 開始日期 欄位到生成 eSIM 配置端點。對於少數幾個套餐（約 30 個，總共超過 28,000 個），此欄位是 必填。

您可以通過檢查包裹對象中的 requirements.travelDate 是否為 true 來識別這些包裹。如果需要但未提供，則配置檔生成請求將失敗。

完整的 API 參考 #

完整的文檔可在 docs.getroamify.com.

如果您有任何問題或需要幫助更新您的集成，請聯繫我們的合作夥伴支持團隊。