Roamify eSIM API тағйиротҳои шикастани
Donald Bogle
June 9, 2026 22:20
Мо маҷмӯи навсозиҳои API-ро, ки нуқтаҳои нави охир, функсионалияти васеъ ва чанд тағйиротро, ки шумо бояд пеш аз навсозии интегратсияатон огоҳ бошед, пешниҳод мекунем.
⚠️ Тагйиротҳои шикаст — Пакетҳои eSIM-ро гиред #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Ҷавоб ҳоло саҳифабандӣ шудааст #
Ин нуқтаи охир ҳоло баргардонидани саҳифабандии натиҷаҳо ба ҷои ҳамаи пакетҳо дар як ҷавоб. Агар интегратсияатон пакетҳоро бидуни параметрҳои саҳифабандӣ бардорад, шояд шумо танҳо саҳифаи аввалини натиҷаҳоро мегиред.
Амали зарурӣ: Интегратсияи худро барои коркарди ҷавобҳои саҳифабандӣ бо истифода аз саҳифа ва pageSize параметрҳои пурсиш навсозӣ кунед.
| Параметр | Навъ | Пешфарз | Тавсиф |
|---|---|---|---|
| саҳифа | сатр | 1 | Номери саҳифаро барои гирифтани. |
| саҳифанавис | сатр | 50 | Шумораи натиҷаҳо дар як саҳифа. |
Барои гирифтани ҳамаи пакетҳо, тавассути саҳифаҳо давр занед, то вақте ки ҷавоб камтар натиҷаҳо баргардонад, аз саҳифанавис.
2. давлат ва countryCode ҳоло маънои алоҳида доранд #
Пештар ин майдонҳо шояд бо ҳамдигар иваз карда мешуданд. Ҳоло онҳо мақсадҳои гуногун доранд ва ҳарду бояд арзишҳоро аз GET /api/esim/countries нуқтаи охир — зангҳои тасодуфӣ дигар қабул намешаванд.
| Параметр | Арзиши қабулшуда | Манбаъ |
|---|---|---|
| давлат | Номи пурраи давлат | майдони ном аз API-и Давлат |
| countryCode | Коди кишвар ISO | код майдони API кишвар |
Амали зарурӣ: Агар шумо ҳоло матнҳои кишварро бо текст озод гузаронида истода бошед, интегратсияи худро навсозӣ кунед, то аввалGET /api/esim/countries ва ном ё код арзишҳоро аз ҷавоб истифода баред.
Нуктаҳои нав #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Рӯйхати ҳамаи кишварҳое, ки eSIM-и Roamify-ро дастгирӣ мекунанд, бармегардонад. Аз ном ва код арзишҳо аз ин ҷавоб ҳамчун вурудҳои фильтр ҳангоми пурсиш кардан GET /api/esim/packages.
параметри фильтри ихтиёрӣ бо геграфия
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Паёмро мустақиман ба eSIM фиристед.
| Ном | Навъ | Зарурӣ | Тавсиф |
|---|---|---|---|
| iccid | стринг | зарурӣ | ICCID-и eSIM, ки SMS-ро ба он фиристодан лозим аст. |
| пайغام | стринг | зарурӣ | Мазмуни паём, ки бояд фиристода шавад. |
Нақшаҳои навшуда #
POST /api/esim/apply — startDate ҳоло дастгирӣ мешавад #
Як майдони нави ихтиёрӣ startDate ба нуқтаи охири Генератсияи Профили eSIM илова карда шудааст. Барои як гурӯҳи хурсанде аз пакетҳо (~30 аз 28,000+), ин майдон зарурӣ.
Шумо метавонед ин бастаҳоро бо санҷидани он, ки requirements.travelDate дар true дар объекти бастаи. Агар лозим бошад ва пешниҳод нагардад, дархости тавлиди профил ноком хоҳад шуд.
| Ном | Навъ | Лозим | Тавсиф |
|---|---|---|---|
| startDate | стринг | шартӣ | Санаи оғози сафар дар формати ISO 8601. Агар requirements.travelDate ҳақиқӣ бошад, лозим аст. |
Ёддошти таймер
Маъруфи API #
Маъруфи пурра дар docs.getroamify.com.
Агар шумо саволҳо дошта бошед ё кӯмак дар навсозии интегратсияатон лозим бошад, ба дастаи дастгирии шарикони мо муроҷиат кунед.
Нақшаҳои таъиноти eSIM алоқаманд
Саволҳои зуд-зуд додашаванда
- Ман дар Roamify eSIM API тағйиротҳои шикастани чиро меомӯзам?
- Шумо мефаҳмед, ки фаъолсозии eSIM чӣ гуна кор мекунад, чӣ гуна муқоиса кардани нақшаҳои маълумот ва кадом қадамҳои танзим пеш аз сафар ва ҳангоми сафар муҳимтаранд.
- Чӣ тавр ман нақшаи дурусти eSIM-ро барои Ҷопон интихоб кунам?
- Нақшаи худро ба дарозии сафар, истифодаи интизории маълумоти ҳаррӯза, ниёзҳои нуқтаи дастрас ва сифати шабака дар таъиноти худ мувофиқ кунед. Вақтҳои кӯтоҳ одатан ба маълумоти камтар ниёз доранд, дар ҳоле ки кори дурдаст ва зангҳои видеоӣ бештар ниёз доранд.
- Ман аз куҷо метавонам нақшаҳои eSIM-и сафарро барои Ҷопон ва Таиланд харам?
- Истинодҳои таъинот дар ин дастурро истифода баред, то мустақиман ба саҳифаҳои кишварии Roamify гузаред, имконоти нақшаро муқоиса кунед ва пеш аз сафар ҳисобро анҷом диҳед.