eSIM指南阅读约 1 分钟

Roamify eSIM API 重大变更

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

Donald Bogle

Donald Bogle

Roamify 编辑团队

Roamify eSIM API 重大变更

我们正在推出一系列 API 更新,带来新的端点、扩展的功能,以及在更新集成之前您需要注意的一些更改。

⚠️ 重大变更 — 获取 eSIM 套餐 #

端点: GET /api/esim/packages

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

1. 响应现在是分页的 #

此端点现在返回 分页结果 而不是在单个响应中返回所有套餐。如果您的集成在没有分页参数的情况下获取套餐,您可能只会收到第一页面的结果。

需要采取的行动: 更新您的集成以使用 pagepageSize 查询参数处理分页响应。

参数类型默认描述
页面字符串1要检索的页面编号。
页面大小字符串50每页的结果数量。

要检索所有套餐,请迭代页面,直到响应返回的结果少于您的 页面大小.

2. 国家countryCode 现在有不同的含义 #

之前这些字段可能可以互换使用。它们现在有不同的用途,并且 两者必须使用来自 GET /api/esim/countries 端点的值 — 不再接受任意字符串。

参数接受的值来源
国家完整国家名称来自国家 API 的 name 字段
countryCodeISO 国家代码来自国家 API 的代码字段

需要采取的行动: 如果您当前正在传递自由文本国家字符串,请更新您的集成,首先调用 GET /api/esim/countries 并使用响应中的 namecode 值。

新端点 #

GET /api/esim/countries #

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

返回 Roamify eSIM 支持的所有国家的列表。使用 namecode 从此响应中作为过滤输入进行查询时使用 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 激活的工作原理、如何比较数据计划以及旅行前和旅行期间哪些设置步骤最重要。

即时激活

准备前往新目的地?落地即可保持联网。

覆盖 200+ 目的地的实惠旅行流量。无漫游费,无隐藏费用,扫码即用。

继续阅读

全部文章
秘鲁的eSIM:2026年完整连接指南
国家提示

秘鲁的eSIM:2026年完整连接指南

计划在2026年去秘鲁旅行吗?通过无忧的eSIM在利马、库斯科、马丘比丘、圣谷和亚马逊保持连接。了解如何检查设备兼容性、选择合适的数据计划、了解各地区的覆盖范围,以及在eSIM和本地SIM之间做出选择。发现为什么Roamify的经济实惠、仅数据的eSIM(起价$2)非常适合希望在抵达时立即激活、无需漫游费用,并在整个秘鲁享受可靠移动数据的旅行者。

Marissa Ling Marissa Ling
2026年沙特阿拉伯的eSIM:作为游客如何保持连接
国家提示

2026年沙特阿拉伯的eSIM:作为游客如何保持连接

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

Michael HarbourMichael Harbour
Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
国家提示

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.

Donald BogleDonald Bogle