Roamify eSIM API pārtraukuma izmaiņas
Donald Bogle
June 9, 2026 22:20
Mēs ieviešam API atjauninājumu komplektu, kas piedāvā jaunus galapunktus, paplašinātu funkcionalitāti un dažas izmaiņas, par kurām jums jāzina pirms integrācijas atjaunināšanas.
⚠️ Lūzuma izmaiņas — Iegūstiet eSIM pakotnes #
Galapunkts: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Atbilde tagad ir lapota #
Šis galapunkts tagad atgriež lapotas rezultātus vietā, lai atgrieztu visas pakotnes vienā atbildē. Ja jūsu integrācija iegūst pakotnes bez lapošanas parametriem, iespējams, jūs saņemat tikai pirmo rezultātu lapu.
Nepieciešama darbība: Atjauniniet savu integrāciju, lai apstrādātu lapotas atbildes, izmantojot page un pageSize vaicājuma parametrus.
| Parametrs | Tips | Noklusējums | Apraksts |
|---|---|---|---|
| lapa | virkne | 1 | Lapas numurs, ko iegūt. |
| lapaIzmērs | virkne | 50 | Rezultātu skaits vienā lapā. |
Lai iegūtu visus pakotnes, atkārtojiet lapas, līdz atbilde atgriež mazāk rezultātu nekā jūsu lapaIzmērs.
2. valsts un valstsKods tagad ir atšķirīgas nozīmes #
Iepriekš šie lauki varēja tikt izmantoti savstarpēji. Tagad tie kalpo dažādiem mērķiem un abiem jāizmanto vērtības, kas iegūtas no GET /api/esim/countries endpoint — nejauši teksti vairs netiek pieņemti.
| Parametrs | Pieņemamā vērtība | Avots |
|---|---|---|
| valsts | Pilns valsts nosaukums | nosaukuma lauks no Country API |
| valstsKods | ISO valsts kods | koda lauks no Country API |
Nepieciešama darbība: Ja pašlaik nosūtāt brīva teksta valsts virknes, atjauniniet savu integrāciju, lai vispirms izsauktu GET /api/esim/countries un izmantotu nosaukums vai kods vērtības no atbildes.
Jauni galapunkti #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Atgriež visu valstu sarakstu, ko atbalsta Roamify eSIM. Izmantojiet name un code vērtības no šī atbildes kā filtrēšanas ievades, kad vaicājat GET /api/esim/packages.
papildu filtrēšanas parametrs pieejams ar geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Nosūtiet SMS ziņojumu tieši uz eSIM.
| Nosaukums | Tips | Nepieciešams | Apraksts |
|---|---|---|---|
| iccid | virkne | prasīts | eSIM ICCID, uz kuru nosūtīt SMS. |
| ziņojums | virkne | prasīts | Ziņojuma saturs, ko nosūtīt. |
Atjauninātie galapunkti #
POST /api/esim/apply — sākumaDatums tagad atbalstīts #
Jauns opciju sākumaDatums lauks ir pievienots eSIM profila ģenerēšanas galapunktam. Nelielai pakotņu grupai (~30 no 28,000+), šis lauks ir prasīts.
Jūs varat identificēt šīs pakotnes, pārbaudot, vai prasības.ceļojumaDatums ir patiesi pakotnes objektā. Ja nepieciešams un nav norādīts, profila ģenerēšanas pieprasījums neizdosies.
| Vārds | Tips | Nepieciešams | Apraksts |
|---|---|---|---|
| sākumaDatums | virkne | nosacīts | Ceļojuma sākuma datums ISO 8601 formātā. Nepieciešams, ja prasības.travelDate ir patiesas. |
Laika ierobežojuma atgādinājums
Pilna API atsauce #
Pilna dokumentācija ir pieejama docs.getroamify.com.
Ja jums ir kādi jautājumi vai nepieciešama palīdzība, atjauninot savu integrāciju, sazinieties ar mūsu partneru atbalsta komandu.
Saistītie eSIM galamērķa plāni
Bieži uzdotie jautājumi
- Ko es uzzināšu Roamify eSIM API pārtraukuma izmaiņas?
- Jūs uzzināsit, kā darbojas eSIM aktivizēšana, kā salīdzināt datu plānus un kuras iestatīšanas darbības ir vissvarīgākās pirms ceļojuma un tā laikā.
- Kā izvēlēties pareizo eSIM plānu valstij Japāna?
- Saskaņojiet savu plānu ar ceļojuma garumu, paredzamo ikdienas datu lietojumu, tīklāja vajadzībām un tīkla kvalitāti jūsu galamērķī. Īsai uzturēšanās laikam parasti ir nepieciešams mazāk datu, savukārt attālinātam darbam un videozvaniem ir nepieciešams vairāk datu.
- Kur es varu iegādāties ceļojumu eSIM plānus Japāna un Taizeme?
- Izmantojiet šajā ceļvedī esošās galamērķa saites, lai dotos tieši uz Roamify valstu lapām, salīdzinātu plāna iespējas un pabeigtu izrakstīšanos pirms izbraukšanas.