Roamify eSIM API 破壊的変更
Donald Bogle
June 9, 2026 22:20
新しいエンドポイント、拡張された機能、そしていくつかの変更をもたらすAPIアップデートを展開しています。統合を更新する前に知っておくべきことがあります。
⚠️ 重大な変更 — eSIMパッケージを取得 #
エンドポイント： GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. レスポンスがページネーションされるようになりました #
このエンドポイントは今後、ページネーションされた結果を返すようになり、単一のレスポンスで全てのパッケージを返すことはありません。ページネーションパラメータなしでパッケージを取得する統合の場合、結果の最初のページのみを受け取る可能性があります。
必要なアクション： ページネーションされたレスポンスを処理するために統合を更新し、pageおよびpageSizeクエリパラメータを使用してください。
| パラメータ | タイプ | デフォルト | 説明 |
|---|---|---|---|
| ページ | 文字列 | 1 | 取得するページ番号。 |
| ページサイズ | 文字列 | 50 | ページごとの結果数。 |
すべてのパッケージを取得するには、応答が ページサイズ より少ない結果を返すまでページを繰り返します。
2. 国 と 国コード は現在異なる意味を持っています #
以前はこれらのフィールドは同じ意味で使用されていたかもしれません。現在は異なる目的で使用され、両方ともから取得した値を使用する必要があります GET /api/esim/countries エンドポイント — 任意の文字列はもう受け付けられません。
| パラメータ | 受け入れられる値 | ソース |
|---|---|---|
| 国 | 完全な国名 | Country API の name フィールド |
| 国コード | ISO 国コード | Country API の code フィールド |
必要なアクション： 現在フリーテキストの国名文字列を渡している場合は、最初に 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。
オプションのフィルターパラメータは で利用可能地理
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
eSIMに直接SMSメッセージを送信します。
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| iccid | string | required | SMSを送信するeSIMのICCID。 |
| message | string | required | 送信するメッセージ内容。 |
更新されたエンドポイント #
POST /api/esim/apply — startDate 現在サポートされています #
新しいオプションの startDate フィールドがGenerate eSIM Profileエンドポイントに追加されました。パッケージのごく一部（28,000以上のうち約30）では、このフィールドが 必須です。
これらのパッケージは、 が であるかどうかを確認することで識別できますrequirements.travelDateがtrue であるかどうかを確認することで識別できますパッケージオブジェクト内で。必要で提供されていない場合、プロファイル生成リクエストは失敗します。
| 名前 | タイプ | 必須 | 説明 |
|---|---|---|---|
| startDate | string | 条件付き | ISO 8601形式での旅行開始日。requirements.travelDateがtrueの場合は必須です。 |
タイムアウトリマインダー
完全なAPIリファレンス #
完全なドキュメントは で利用可能ですdocs.getroamify.com。
ご質問や統合の更新に関するサポートが必要な場合は、パートナーサポートチームにお問い合わせください。
関連する eSIM 宛先プラン
よくある質問
- Roamify eSIM API 破壊的変更 では何を学ぶことができますか?
- eSIM アクティベーションの仕組み、データ プランの比較方法、旅行前および旅行中に最も重要な設定手順について学びます。
- 日本 に適切な eSIM プランを選択するにはどうすればよいですか?
- 旅行の長さ、予想される毎日のデータ使用量、ホットスポットのニーズ、目的地のネットワーク品質に合わせて計画を立ててください。通常、短期滞在では必要なデータ量は少なくなりますが、リモートワークやビデオ通話ではより多くのデータ量が必要になります。
- 日本 および タイ のトラベル eSIM プランはどこで購入できますか?
- このガイドの目的地リンクを使用して、Roamify の国別ページに直接移動し、プラン オプションを比較し、出発前にチェックアウトを完了します。