Roamify eSIM API Thay Đổi Đột Phá
Donald Bogle
June 9, 2026 22:20
Chúng tôi đang triển khai một loạt các cập nhật API mang đến các điểm cuối mới, chức năng mở rộng và một vài thay đổi mà bạn sẽ muốn biết trước khi cập nhật tích hợp của mình.
⚠️ Thay đổi quan trọng — Nhận gói eSIM #
Điểm cuối: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Phản hồi hiện đã được phân trang #
Điểm cuối này hiện trả về kết quả phân trang thay vì tất cả các gói trong một phản hồi duy nhất. Nếu tích hợp của bạn lấy gói mà không có tham số phân trang, bạn có thể chỉ nhận được trang đầu tiên của kết quả.
Hành động cần thiết: Cập nhật tích hợp của bạn để xử lý các phản hồi phân trang bằng cách sử dụng các tham số truy vấn page và pageSize.
| Tham số | Loại | Mặc định | Mô tả |
|---|---|---|---|
| trang | chuỗi | 1 | Số trang để lấy. |
| kích thướcTrang | chuỗi | 50 | Số kết quả trên mỗi trang. |
Để lấy tất cả các gói, lặp qua các trang cho đến khi phản hồi trả về ít kết quả hơn giá trị của bạn kích thướcTrang.
2. quốc gia và mãQuốcGia hiện có ý nghĩa khác nhau #
Trước đây, các trường này có thể đã được sử dụng thay thế cho nhau. Giờ đây, chúng phục vụ các mục đích khác nhau và cả hai đều phải sử dụng các giá trị được lấy từ GET /api/esim/countries endpoint — các chuỗi tùy ý không còn được chấp nhận.
| Parameter | Accepted value | Source |
|---|---|---|
| country | Tên đầy đủ của quốc gia | name field from the Country API |
| countryCode | Mã quốc gia ISO | code field from the Country API |
Action required: Nếu bạn đang truyền các chuỗi quốc gia văn bản tự do, hãy cập nhật tích hợp của bạn để gọi trước GET /api/esim/countries và sử dụng các giá trị name hoặc code từ phản hồi.
Điểm cuối mới #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Trả về danh sách tất cả các quốc gia được hỗ trợ bởi Roamify eSIM. Sử dụng các giá trị name và code từ phản hồi này làm đầu vào bộ lọc khi truy vấn GET /api/esim/packages.
tham số bộ lọc tùy chọn có sẵn với geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Gửi tin nhắn SMS trực tiếp đến một eSIM.
| Tên | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| iccid | chuỗi | bắt buộc | ICCID của eSIM để gửi SMS đến. |
| tin nhắn | chuỗi | bắt buộc | Nội dung tin nhắn để gửi. |
Các Điểm Kết Nối Đã Cập Nhật #
POST /api/esim/apply — ngày bắt đầu hiện được hỗ trợ #
Một trường ngày bắt đầu tùy chọn mới đã được thêm vào điểm cuối Tạo Hồ Sơ eSIM. Đối với một nhóm nhỏ các gói (~30 trong số 28,000+), trường này là bắt buộc.
Bạn có thể xác định các gói này bằng cách kiểm tra xem requirements.travelDate có giá trị true trong đối tượng gói. Nếu cần và không được cung cấp, yêu cầu tạo hồ sơ sẽ thất bại.
| Tên | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| startDate | chuỗi | có điều kiện | Ngày bắt đầu chuyến đi theo định dạng ISO 8601. Bắt buộc nếu requirements.travelDate là true. |
Nhắc nhở thời gian chờ
Tài liệu API đầy đủ #
Tài liệu đầy đủ có sẵn tại docs.getroamify.com.
Nếu bạn có bất kỳ câu hỏi nào hoặc cần trợ giúp cập nhật tích hợp của mình, hãy liên hệ với đội ngũ hỗ trợ đối tác của chúng tôi.
Các gói đích eSIM liên quan
Câu hỏi thường gặp
- Tôi sẽ học được gì trong Roamify eSIM API Thay Đổi Đột Phá?
- Bạn sẽ tìm hiểu cách hoạt động của quá trình kích hoạt eSIM, cách so sánh các gói dữ liệu và bước thiết lập nào quan trọng nhất trước và trong chuyến đi của bạn.
- Làm cách nào để chọn gói eSIM phù hợp cho Nhật Bản?
- Hãy điều chỉnh kế hoạch của bạn với độ dài chuyến đi, mức sử dụng dữ liệu dự kiến hàng ngày, nhu cầu điểm truy cập và chất lượng mạng ở điểm đến của bạn. Thời gian lưu trú ngắn ngày thường cần ít dữ liệu hơn, trong khi làm việc từ xa và gọi video cần nhiều dữ liệu hơn.
- Tôi có thể mua gói eSIM du lịch cho Nhật Bản và Thái Lan ở đâu?
- Sử dụng các liên kết điểm đến trong hướng dẫn này để truy cập trực tiếp vào trang quốc gia của Roamify, so sánh các tùy chọn gói và hoàn tất thanh toán trước khi khởi hành.