我将在 Roamify eSIM API 重大变更中学到什么？

您将了解 eSIM 激活的工作原理、如何比较数据计划以及旅行前和旅行期间哪些设置步骤最重要。

如何选择适合日本的 eSIM 套餐？

将您的计划与行程长度、预期每日数据使用量、热点需求以及目的地的网络质量相匹配。短期停留通常需要较少的数据流量，而远程工作和视频通话则需要更多的数据流量。

使用本指南中的目的地链接直接转至 Roamify 国家/地区页面、比较计划选项并在出发前完成结账。

eSIM指南·June 9, 2026 22:20

Donald Bogle

June 9, 2026 22:20

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

端点： GET /api/esim/packages

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

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

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

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

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

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

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

返回 Roamify eSIM 支持的所有国家的列表。使用 name 和 code 从此响应中作为过滤输入进行查询时使用 GET /api/esim/packages.

可选过滤参数可与 geography

直接向eSIM发送短信。

名称	类型	必需	描述
iccid	字符串	必填	要发送短信的 eSIM 的 ICCID。
消息	字符串	必填	要发送的消息内容。

已添加一个新的可选的 开始日期 字段到生成 eSIM 配置文件的端点。对于一小部分套餐（约 30 个，超过 28,000 个），此字段是必填.

您可以通过检查包对象中的 requirements.travelDate 是否为 true 来识别这些包。如果需要但未提供，配置文件生成请求将失败。

名称	类型	必需	描述
开始日期	字符串	条件	如果 requirements.travelDate 为 true，则需要以 ISO 8601 格式提供的旅行开始日期。

记得在调用 /api/esim/apply 时将请求超时设置为至少 60 秒。

完整文档可在 docs.getroamify.com.

如果您有任何问题或需要帮助更新您的集成，请联系我们的合作伙伴支持团队。

Donald Bogle

June 9, 2026 22:20

用 AI 总结

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