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. პასუხი ახლა არის გვერდობრივი #
ეს ბოლო წერტილი ახლა აბრუნებს გვერდობრივ შედეგებს ყველა პაკეტის ნაცვლად ერთ პასუხში. თუ თქვენი ინტეგრაცია იღებს პაკეტებს გვერდობრივი პარამეტრების გარეშე, შესაძლოა მხოლოდ პირველი გვერდის შედეგები მიიღოთ.
მოქმედება საჭირო: განაახლეთ თქვენი ინტეგრაცია, რომ მოემსახუროს გვერდობრივ პასუხებს გვერდის და გვერდის ზომა კითხვის პარამეტრებით.
| პარამეტრი | ტიპი | ნაგულისხმები | აღწერა |
|---|---|---|---|
| გვერდი | სტრიქონი | 1 | გვერდის ნომერი, რომელიც უნდა მოიძიოთ. |
| გვერდის ზომა | სტრიქონი | 50 | შედეგების რაოდენობა თითო გვერდზე. |
ყველა პაკეტის მოსაძიებლად, უნდა გაიაროთ გვერდები სანამ პასუხი არ დააბრუნებს ნაკლებ შედეგს ვიდრე თქვენი გვერდის ზომა.
2. ქვეყანა და ქვეყნის კოდი ახლა განსხვავებული მნიშვნელობები აქვთ #
წინათ ეს ველები შეიძლება გამოყენებულიყო ურთიერთგამომრიცხავად. ახლა ისინი სხვადასხვა მიზნებისთვის ემსახურებიან და ორივე უნდა გამოიყენოს მნიშვნელობები, რომლებიც მიღებულია GET /api/esim/countries endpoint — შემთხვევითი სტრიქონები აღარ მიიღება.
| პარამეტრი | მიღებული მნიშვნელობა | წყარო |
|---|---|---|
| ქვეყანა | სრული ქვეყნის სახელი | სახელი ველი Country API-დან |
| ქვეყნის კოდი | ISO ქვეყნის კოდი | კოდი ველი Country API-დან |
მოქმედება საჭირო: თუ ამჟამად გადასცემთ თავისუფალ ტექსტურ ქვეყნის სტრიქონებს, განაახლეთ თქვენი ინტეგრაცია, რომ პირველად გამოიძახოთ 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.
ოპციური ფილტრის პარამეტრი ხელმისაწვდომია geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
გააგზავნეთ SMS შეტყობინება პირდაპირ eSIM-ზე.
| სახელი | ტიპი | მოსახერხებელია | აღწერა |
|---|---|---|---|
| iccid | სტრინგი | სავალდებულო | eSIM-ის ICCID, რომლითაც უნდა გაიგზავნოს SMS. |
| მესიჯი | სტრინგი | სავალდებულო | მესიჯის შინაარსი, რომელიც უნდა გაიგზავნოს. |
განახლებული ბოლო წერტილები #
POST /api/esim/apply — დაწყების თარიღიახლა მხარდაჭერილია #
ახალი სავალდებულო დაწყების თარიღიფილიალი დაემატა Generate eSIM Profile ბოლო წერტილში. მცირე პაკეტების ნაკრებისთვის (~30 28,000+-დან), ეს ფილიალი არის სავალდებულო.
თქვენ შეგიძლიათ ამ პაკეტების იდენტიფიცირება გააკეთოთ, თუ requirements.travelDate არის მართალი პაკეტის ობიექტში. თუ საჭიროა და არ არის გაწვდილი, პროფილის გენერაციის მოთხოვნა ჩაიშლება.
| სახელი | ტიპი | საჭირო | აღწერა |
|---|---|---|---|
| დაწყების თარიღი | სტრინგი | პირობითი | მოგზაურობის დაწყების თარიღი ISO 8601 ფორმატში. საჭიროა, თუ requirements.travelDate ჭეშმარიტია. |
დროის გასვლის გახსენება
სრული API მითითება #
სრული დოკუმენტაცია ხელმისაწვდომია docs.getroamify.com.
თუ გაქვთ რაიმე შეკითხვა ან დახმარება გჭირდებათ თქვენი ინტეგრაციის განახლებისას, დაუკავშირდით ჩვენს პარტნიორ მხარდაჭერის გუნდს.
დაკავშირებული eSIM დანიშნულების გეგმები
ხშირად დასმული კითხვები
- რას ვისწავლი Roamify eSIM API ცვლილებები-ში?
- თქვენ შეიტყობთ, თუ როგორ მუშაობს eSIM აქტივაცია, როგორ შეადაროთ მონაცემთა გეგმები და დაყენების რომელი ნაბიჯებია ყველაზე მნიშვნელოვანი თქვენი მოგზაურობის წინ და მის დროს.
- როგორ ავირჩიო სწორი eSIM გეგმა იაპონია-ისთვის?
- შეადარეთ თქვენი გეგმა მოგზაურობის ხანგრძლივობას, მონაცემთა მოსალოდნელ ყოველდღიურ გამოყენებას, ცხელი წერტილის საჭიროებებს და ქსელის ხარისხს თქვენს დანიშნულების ადგილზე. ხანმოკლე ყოფნას, როგორც წესი, ნაკლები მონაცემები სჭირდება, ხოლო დისტანციურ მუშაობას და ვიდეო ზარებს მეტი.
- სად შემიძლია ვიყიდო სამოგზაურო eSIM გეგმები იაპონია-ისა და ტაილანდი-ისთვის?
- გამოიყენეთ დანიშნულების ბმულები ამ სახელმძღვანელოში, რომ პირდაპირ გადახვიდეთ Roamify ქვეყნის გვერდებზე, შეადაროთ გეგმის ვარიანტები და დაასრულოთ გადახდა გამგზავრებამდე.