Roamify eSIM API Schimbări Importante
Donald Bogle
June 9, 2026 22:20
Lansăm un set de actualizări API care aduc noi endpoint-uri, funcționalitate extinsă și câteva modificări de care ar trebui să fiți conștienți înainte de a actualiza integrarea dumneavoastră.
⚠️ Modificări majore — Obțineți pachete eSIM #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Răspunsul este acum paginat #
Acest endpoint returnează acum rezultate paginate în loc de toate pachetele într-un singur răspuns. Dacă integrarea dumneavoastră obține pachete fără parametrii de paginare, este posibil să primiți doar prima pagină de rezultate.
Acțiune necesară: Actualizați integrarea dumneavoastră pentru a gestiona răspunsurile paginate folosind parametrii de interogare page și pageSize.
| Parametru | Tip | Implicit | Descriere |
|---|---|---|---|
| pagina | șir | 1 | Numărul paginii de recuperat. |
| dimensiunePagina | șir | 50 | Numărul de rezultate pe pagină. |
Pentru a recupera toate pachetele, iterați prin pagini până când răspunsul returnează mai puține rezultate decât dimensiunePagina.
2. țară și codulTării au acum semnificații distincte #
Anterior, aceste câmpuri puteau fi folosite interschimbabil. Acum servesc scopuri diferite și ambele trebuie să folosească valori provenite din GET /api/esim/countries endpoint — șiruri arbitrare nu mai sunt acceptate.
| Parameter | Valoare acceptată | Sursă |
|---|---|---|
| țară | Numele complet al țării | câmpul name din API-ul Țării |
| countryCode | codul ISO al țării | câmpul code din API-ul Țării |
Acțiune necesară: Dacă în prezent trimiteți șiruri de țări în text liber, actualizați integrarea dvs. pentru a apela mai întâi GET /api/esim/countries și utilizați valorile name sau code din răspuns.
Noi puncte finale #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Returnează o listă cu toate țările suportate de Roamify eSIM. Folosește valorile name și code din acest răspuns ca inputuri de filtrare atunci când interoghezi GET /api/esim/packages.
parametru de filtrare opțional disponibil cu geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Trimite un mesaj SMS direct către un eSIM.
| Nume | Tip | Necesar | Descriere |
|---|---|---|---|
| iccid | string | required | ICCID-ul eSIM-ului la care să trimiteți SMS-ul. |
| message | string | required | Conținutul mesajului de trimis. |
Updated Endpoints #
POST /api/esim/apply — startDate acum acceptat #
Un nou câmp opțional startDate a fost adăugat la endpoint-ul Generare Profil eSIM. Pentru un mic subset de pachete (~30 din 28,000+), acest câmp este required.
Puteți identifica aceste pachete verificând dacă requirements.travelDate este true în obiectul pachetului. Dacă este necesar și nu este furnizat, cererea de generare a profilului va eșua.
| Nume | Tip | Necesar | Descriere |
|---|---|---|---|
| startDate | string | condițional | Data de început a călătoriei în format ISO 8601. Necesare dacă requirements.travelDate este adevărat. |
Memento timeout
Referință API completă #
Documentația completă este disponibilă la docs.getroamify.com.
Dacă ai întrebări sau ai nevoie de ajutor pentru actualizarea integrării tale, contactează echipa noastră de suport pentru parteneri.
Planuri de destinație eSIM înrudite
Întrebări frecvente
- Ce voi învăța în Roamify eSIM API Schimbări Importante?
- Veți afla cum funcționează activarea eSIM, cum să comparați planurile de date și ce pași de configurare contează cel mai mult înainte și în timpul călătoriei.
- Cum aleg planul eSIM potrivit pentru Japonia?
- Potriviți planul cu durata călătoriei, utilizarea zilnică estimată a datelor, nevoile hotspot-ului și calitatea rețelei din destinația dvs. Sejururile scurte au nevoie de obicei de mai puține date, în timp ce munca de la distanță și apelurile video au nevoie de mai multe.
- De unde pot cumpăra planuri eSIM de călătorie pentru Japonia și Thailanda?
- Utilizați linkurile de destinație din acest ghid pentru a accesa direct paginile de țară Roamify, pentru a compara opțiunile de plan și pentru a finaliza finalizarea plății înainte de plecare.