Αλλαγές στο API του Roamify eSIM που Διαταράσσουν τη Συμβατότητα
Donald Bogle
June 9, 2026 22:20
Δημιουργούμε μια σειρά ενημερώσεων API που φέρνουν νέα endpoints, επεκταμένη λειτουργικότητα και μερικές αλλαγές που θα θέλετε να γνωρίζετε πριν ενημερώσετε την ενσωμάτωσή σας.
⚠️ Σημαντικές Αλλαγές — Λάβετε eSIM Πακέτα #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Η απάντηση είναι τώρα σε σελίδες #
Αυτό το endpoint επιστρέφει τώρα σελιδοποιημένα αποτελέσματα αντί για όλα τα πακέτα σε μία μόνο απάντηση. Εάν η ενσωμάτωσή σας ανακτά πακέτα χωρίς παραμέτρους σελιδοποίησης, μπορεί να λαμβάνετε μόνο την πρώτη σελίδα αποτελεσμάτων.
Απαιτείται ενέργεια: Ενημερώστε την ενσωμάτωσή σας για να διαχειριστείτε τις σελιδοποιημένες απαντήσεις χρησιμοποιώντας τις παραμέτρους ερωτήματος page και pageSize.
| Παράμετρος | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
| σελίδα | κείμενο | 1 | Αριθμός σελίδας προς ανάκτηση. |
| μέγεθοςΣελίδας | κείμενο | 50 | Αριθμός αποτελεσμάτων ανά σελίδα. |
Για να ανακτήσετε όλα τα πακέτα, επαναλάβετε τις σελίδες μέχρι η απάντηση να επιστρέψει λιγότερα αποτελέσματα από το μέγεθοςΣελίδας.
2. χώρα και κωδικόςΧώρας τώρα έχουν διακριτές σημασίες #
Προηγουμένως, αυτά τα πεδία μπορεί να χρησιμοποιούνταν εναλλακτικά. Τώρα εξυπηρετούν διαφορετικούς σκοπούς και και τα δύο πρέπει να χρησιμοποιούν τιμές που προέρχονται από το GET /api/esim/countries endpoint — οι αυθαίρετες συμβολοσειρές δεν γίνονται πλέον αποδεκτές.
| Parameter | Accepted value | Source |
|---|---|---|
| country | Πλήρες όνομα χώρας | name field from the Country API |
| countryCode | ISO country code | code field from the Country API |
Action required: Αν αυτή τη στιγμή στέλνετε ελεύθερες συμβολοσειρές χώρας, ενημερώστε την ενσωμάτωσή σας για να καλέσετε πρώτα 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 | string | required | Το ICCID της eSIM στην οποία θα σταλεί το SMS. |
| message | string | required | Το περιεχόμενο του μηνύματος που θα σταλεί. |
Updated Endpoints #
POST /api/esim/apply — startDate τώρα υποστηρίζεται #
Ένα νέο προαιρετικό startDate πεδίο έχει προστεθεί στο endpoint Δημιουργίας προφίλ eSIM. Για ένα μικρό υποσύνολο πακέτων (~30 από 28,000+), αυτό το πεδίο είναι required.
Μπορείτε να αναγνωρίσετε αυτά τα πακέτα ελέγχοντας αν requirements.travelDate είναι true στο αντικείμενο πακέτου. Εάν απαιτείται και δεν παρέχεται, το αίτημα δημιουργίας προφίλ θα αποτύχει.
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| ημερομηνίαΈναρξης | συμβολοσειρά | προαιρετικό | Η ημερομηνία έναρξης ταξιδιού σε μορφή ISO 8601. Απαιτείται εάν το requirements.travelDate είναι true. |
Υπενθύμιση χρονικού ορίου
Πλήρης Αναφορά API #
Πλήρης τεκμηρίωση είναι διαθέσιμη στο docs.getroamify.com.
Εάν έχετε οποιαδήποτε ερώτηση ή χρειάζεστε βοήθεια για την ενημέρωση της ενσωμάτωσής σας, επικοινωνήστε με την ομάδα υποστήριξης συνεργατών μας.
Σχετικά σχέδια προορισμού eSIM
Συχνές ερωτήσεις
- Τι θα μάθω στο Αλλαγές στο API του Roamify eSIM που Διαταράσσουν τη Συμβατότητα;
- Θα μάθετε πώς λειτουργεί η ενεργοποίηση eSIM, πώς να συγκρίνετε τα προγράμματα δεδομένων και ποια βήματα ρύθμισης έχουν μεγαλύτερη σημασία πριν και κατά τη διάρκεια του ταξιδιού σας.
- Πώς μπορώ να επιλέξω το σωστό πρόγραμμα eSIM για Ιαπωνία;
- Αντιστοιχίστε το σχέδιό σας με τη διάρκεια ταξιδιού, την αναμενόμενη καθημερινή χρήση δεδομένων, τις ανάγκες του hotspot και την ποιότητα δικτύου στον προορισμό σας. Οι σύντομες διαμονές χρειάζονται συνήθως λιγότερα δεδομένα, ενώ η απομακρυσμένη εργασία και οι βιντεοκλήσεις χρειάζονται περισσότερα.
- Πού μπορώ να αγοράσω ταξιδιωτικά προγράμματα eSIM για Ιαπωνία και Ταϊλάνδη;
- Χρησιμοποιήστε τους συνδέσμους προορισμού σε αυτόν τον οδηγό για να μεταβείτε απευθείας στις σελίδες της χώρας Roamify, να συγκρίνετε τις επιλογές του προγράμματος και να ολοκληρώσετε την ολοκλήρωση της ολοκλήρωσης αγοράς πριν από την αναχώρηση.