Hướng dẫn eSIM3 phút đọc

Roamify eSIM API Thay Đổi Đột Phá

Khám phá những cập nhật mới nhất của API eSIM Roamify, bao gồm các phản hồi phân trang mới cho GET /api/esim/packages, xác thực quốc gia và mã quốc gia nghiêm…

Donald Bogle

Donald Bogle

Đội ngũ biên tập Roamify

Roamify eSIM API Thay Đổi Đột Phá

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 pagepageSize.

Tham sốLoạiMặc địnhMô tả
trangchuỗi1Số trang để lấy.
kích thướcTrangchuỗi50Số 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 giamã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.

ParameterAccepted valueSource
countryTên đầy đủ của quốc gianame field from the Country API
countryCodeMã quốc gia ISOcode 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ị namecode 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ênLoạiBắt buộcMô tả
iccidchuỗibắt buộcICCID của eSIM để gửi SMS đến.
tin nhắnchuỗibắt buộcNộ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ênLoạiBắt buộcMô tả
startDatechuỗicó điều kiệnNgày bắt đầu chuyến đi theo định dạng ISO 8601. Bắt buộc nếu requirements.travelDate là true.

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âu hỏi thường gặp

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.

Kích hoạt tức thì

Sắp đến một nơi mới? Kết nối ngay khi bạn vừa hạ cánh.

Dữ liệu di động giá rẻ cho hơn 200 điểm đến. Không phí chuyển vùng, không phí ẩn, chỉ cần quét và lên đường.

eSIM cho Peru: Hướng dẫn kết nối hoàn chỉnh cho năm 2026
Mẹo Du Lịch Quốc Gia

eSIM cho Peru: Hướng dẫn kết nối hoàn chỉnh cho năm 2026

Bạn đang lên kế hoạch cho một chuyến đi đến Peru vào năm 2026? Hãy giữ kết nối ở Lima, Cusco, Machu Picchu, Thung lũng Thiêng và Amazon với eSIM không rắc rối. Tìm hiểu cách kiểm tra tính tương thích của thiết bị, chọn gói dữ liệu phù hợp, hiểu về vùng phủ sóng và quyết định giữa eSIM và SIM địa phương. Khám phá lý do tại sao eSIM chỉ dữ liệu giá cả phải chăng của Roamify (từ 2 đô la) là lý tưởng cho những du khách muốn kích hoạt ngay khi đến nơi, không phí roaming và dữ liệu di động đáng tin cậy trên toàn Peru.

Marissa Ling Marissa Ling
eSIM cho Ả Rập Xê Út: Cách giữ kết nối khi là khách du lịch vào năm 2026
Mẹo Du Lịch Quốc Gia

eSIM cho Ả Rập Xê Út: Cách giữ kết nối khi là khách du lịch vào năm 2026

Bạn đang lên kế hoạch cho một chuyến đi đến Ả Rập Xê Út vào năm 2026? Hãy bỏ qua việc roaming đắt đỏ và xếp hàng mua SIM tại sân bay bằng cách sử dụng eSIM du lịch. Hướng dẫn này giải thích về tính tương thích của eSIM, vùng phủ sóng trên STC, Mobily và Zain, khả năng 4G/5G tại Riyadh, Jeddah, Mecca, Medina và AlUla, bạn thực sự cần bao nhiêu dữ liệu, và hướng dẫn từng bước để thiết lập eSIM trước khi bạn bay. So sánh các nhà cung cấp hàng đầu như Roamify, Airalo và Holafly, tìm hiểu về việc sử dụng VPN và ứng dụng (WhatsApp, Telegram, mạng xã hội), và nhận những mẹo thực tế để giữ kết nối suôn sẻ trong suốt Hajj, Umrah, công việc hoặc du lịch giải trí tại Ả Rập Xê Út.

Michael HarbourMichael Harbour
Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
Mẹo Du Lịch Quốc Gia

Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026

Discover the Roamify Partner Program, a high-converting travel eSIM affiliate and reseller opportunity built for bloggers, comparison sites, travel agencies, and digital nomad communities. Promote data-only eSIMs from just $2 with coverage in 200+ countries, a 4.6 Trustpilot rating, top-ranked customer support, and a 5% discount code (ROAM5) to boost conversions. Apply in minutes at partner.getroamify.com and start earning commissions by recommending one of the cheapest, most reliable travel eSIM providers on the market.

Donald BogleDonald Bogle