Roamify eSIM API 重大变更
发现 Roamify 最新的 eSIM API 更新,包括 GET /api/esim/packages 的新分页响应,通过 GET /api/esim/countries 进行更严格的国家和国家代码验证,以及强大的新端点如 POST /api/esim/sms。了解如何更新您的集成以处理分页,使用符合 ISO…

我们正在推出一系列 API 更新,带来新的端点、扩展的功能,以及在更新集成之前您需要注意的一些更改。
⚠️ 重大变更 — 获取 eSIM 套餐 #
端点: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. 响应现在是分页的 #
此端点现在返回 分页结果 而不是在单个响应中返回所有套餐。如果您的集成在没有分页参数的情况下获取套餐,您可能只会收到第一页面的结果。
需要采取的行动: 更新您的集成以使用 page 和 pageSize 查询参数处理分页响应。
| 参数 | 类型 | 默认 | 描述 |
|---|---|---|---|
| 页面 | 字符串 | 1 | 要检索的页面编号。 |
| 页面大小 | 字符串 | 50 | 每页的结果数量。 |
要检索所有套餐,请迭代页面,直到响应返回的结果少于您的 页面大小.
2. 国家 和 countryCode 现在有不同的含义 #
之前这些字段可能可以互换使用。它们现在有不同的用途,并且 两者必须使用来自 GET /api/esim/countries 端点的值 — 不再接受任意字符串。
| 参数 | 接受的值 | 来源 |
|---|---|---|
| 国家 | 完整国家名称 | 来自国家 API 的 name 字段 |
| countryCode | ISO 国家代码 | 来自国家 API 的代码字段 |
需要采取的行动: 如果您当前正在传递自由文本国家字符串,请更新您的集成,首先调用 GET /api/esim/countries 并使用响应中的 name 或 code 值。
新端点 #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
返回 Roamify eSIM 支持的所有国家的列表。使用 name 和 code 从此响应中作为过滤输入进行查询时使用 GET /api/esim/packages.
可选过滤参数可与 geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
直接向eSIM发送短信。
| 名称 | 类型 | 必需 | 描述 |
|---|---|---|---|
| iccid | 字符串 | 必填 | 要发送短信的 eSIM 的 ICCID。 |
| 消息 | 字符串 | 必填 | 要发送的消息内容。 |
更新的端点 #
POST /api/esim/apply — 开始日期 现在支持 #
已添加一个新的可选的 开始日期 字段到生成 eSIM 配置文件的端点。对于一小部分套餐(约 30 个,超过 28,000 个),此字段是 必填.
您可以通过检查包对象中的 requirements.travelDate 是否为 true 来识别这些包。如果需要但未提供,配置文件生成请求将失败。
| 名称 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 开始日期 | 字符串 | 条件 | 如果 requirements.travelDate 为 true,则需要以 ISO 8601 格式提供的旅行开始日期。 |
超时提醒
完整的 API 参考 #
完整文档可在 docs.getroamify.com.
如果您有任何问题或需要帮助更新您的集成,请联系我们的合作伙伴支持团队。
常见问题
您将了解 eSIM 激活的工作原理、如何比较数据计划以及旅行前和旅行期间哪些设置步骤最重要。
将您的计划与行程长度、预期每日数据使用量、热点需求以及目的地的网络质量相匹配。短期停留通常需要较少的数据流量,而远程工作和视频通话则需要更多的数据流量。
使用本指南中的目的地链接直接转至 Roamify 国家/地区页面、比较计划选项并在出发前完成结账。
继续阅读
全部文章
秘鲁的eSIM:2026年完整连接指南
计划在2026年去秘鲁旅行吗?通过无忧的eSIM在利马、库斯科、马丘比丘、圣谷和亚马逊保持连接。了解如何检查设备兼容性、选择合适的数据计划、了解各地区的覆盖范围,以及在eSIM和本地SIM之间做出选择。发现为什么Roamify的经济实惠、仅数据的eSIM(起价$2)非常适合希望在抵达时立即激活、无需漫游费用,并在整个秘鲁享受可靠移动数据的旅行者。

2026年沙特阿拉伯的eSIM:作为游客如何保持连接
计划在2026年去沙特阿拉伯旅行?通过使用旅行eSIM,避免昂贵的漫游费用和机场SIM卡排队。本文指南解释了eSIM的兼容性、STC、Mobily和Zain的覆盖范围、利雅得、吉达、麦加、麦地那和阿尔乌拉的4G/5G可用性、您真正需要的数据量,以及在出发前逐步设置eSIM的方法。比较Roamify、Airalo和Holafly等领先提供商,了解VPN和应用程序的使用(WhatsApp、Telegram、社交媒体),并获得在沙特阿拉伯进行朝觐、乌姆拉、商务或休闲旅行时顺利保持连接的实用技巧。

Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
Discover the Roamify Partner Program, a high-converting travel eSIM affiliate and reseller opportunity built for bloggers, comparison sites, travel agencies, and digital nomad communities. Promote data-only eSIMs from just $2 with coverage in 200+ countries, a 4.6 Trustpilot rating, top-ranked customer support, and a 5% discount code (ROAM5) to boost conversions. Apply in minutes at partner.getroamify.com and start earning commissions by recommending one of the cheapest, most reliable travel eSIM providers on the market.