تغییرات شکستن API eSIM Roamify
آخرین بهروزرسانیهای API eSIM Roamify را کشف کنید، از جمله پاسخهای جدید صفحهبندی شده برای GET /api/esim/packages، اعتبارسنجی سختگیرانهتر کشور و…
ما در حال ارائه مجموعهای از بهروزرسانیهای API هستیم که نقاط پایانی جدید، قابلیتهای گسترشیافته و چند تغییر را به همراه دارد که قبل از بهروزرسانی ادغام خود باید از آنها آگاه باشید.
⚠️ تغییرات شکستن — دریافت بستههای eSIM #
نقطه پایانی: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. پاسخ اکنون صفحهبندی شده است #
این نقطه پایانی اکنون نتایج صفحهبندی شده را به جای همه بستهها در یک پاسخ واحد برمیگرداند. اگر یکپارچهسازی شما بستهها را بدون پارامترهای صفحهبندی دریافت کند، ممکن است فقط صفحه اول نتایج را دریافت کنید.
اقدام لازم: یکپارچهسازی خود را بهروزرسانی کنید تا پاسخهای صفحهبندی شده را با استفاده از page و pageSize پارامترهای کوئری مدیریت کند.
| پارامتر | نوع | پیشفرض | توضیحات |
|---|---|---|---|
| صفحه | رشته | 1 | شماره صفحه برای بازیابی. |
| تعدادصفحه | رشته | 50 | تعداد نتایج در هر صفحه. |
برای بازیابی تمام بستهها، از طریق صفحات تکرار کنید تا زمانی که پاسخ نتایج کمتری از تعدادصفحهبرگرداند.
2. کشور و countryCode اکنون معانی متفاوتی دارند #
قبلاً این فیلدها ممکن است به صورت متقابل استفاده شده باشند. اکنون اهداف متفاوتی دارند و هر دو باید از مقادیر منبع گرفته شده از GET /api/esim/countries نقطه پایانی — رشتههای دلخواه دیگر پذیرفته نمیشوند.
| پارامتر | مقدار پذیرفته شده | منبع |
|---|---|---|
| کشور | نام کامل کشور | فیلد نام از API کشور |
| countryCode | کد کشور ISO | فیلد کد از API کشور |
عملیات مورد نیاز: اگر در حال حاضر رشتههای کشور به صورت متن آزاد را ارسال میکنید، یکپارچگی خود را بهروزرسانی کنید تا ابتدا GET /api/esim/countries را فراخوانی کنید و از name یا code مقادیر پاسخ استفاده کنید.
نقاط پایانی جدید #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
فهرستی از تمام کشورهای پشتیبانی شده توسط Roamify eSIM را برمیگرداند. از name و کد مقادیر این پاسخ را به عنوان ورودیهای فیلتر هنگام جستجو استفاده کنید GET /api/esim/packages.
پارامتر فیلتر اختیاری موجود با جغرافیا
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
یک پیام SMS مستقیماً به یک eSIM ارسال کنید.
| نام | نوع | ضروری | توضیحات |
|---|---|---|---|
| iccid | رشته | ضروری | ICCID eSIM که باید SMS به آن ارسال شود. |
| پیام | رشته | ضروری | محتوای پیام برای ارسال. |
نقاط پایانی بهروز شده #
POST /api/esim/apply — تاریخ شروعاکنون پشتیبانی میشود #
یک فیلد اختیاری جدید تاریخ شروعبه نقطه پایانی تولید پروفایل eSIM اضافه شده است. برای یک زیرمجموعه کوچک از بستهها (~30 از 28,000+)، این فیلد ضروری است.
شما میتوانید این بستهها را با بررسی اینکه requirements.travelDate برابر با true در شیء بسته است شناسایی کنید. اگر لازم باشد و ارائه نشده باشد، درخواست تولید پروفایل ناموفق خواهد بود.
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
| startDate | رشته | شرطی | تاریخ شروع سفر به فرمت ISO 8601. در صورتی که requirements.travelDate برابر با true باشد، الزامی است. |
یادآوری زمانسنج
مرجع کامل API #
مستندات کامل در دسترس است در docs.getroamify.com.
اگر سوالی دارید یا به کمک در بهروزرسانی یکپارچگی خود نیاز دارید، با تیم پشتیبانی شریک ما تماس بگیرید.
سوالات متداول
یاد خواهید گرفت که فعالسازی eSIM چگونه کار میکند، چگونه برنامههای داده را مقایسه کنید، و کدام مراحل راهاندازی قبل و در طول سفرتان مهمتر است.
برنامه خود را با طول سفر، مصرف روزانه داده مورد انتظار، نیازهای نقطه اتصال و کیفیت شبکه در مقصد مطابقت دهید. اقامت های کوتاه معمولاً به داده کمتری نیاز دارد، در حالی که کار از راه دور و تماس های ویدیویی به اطلاعات بیشتری نیاز دارند.
از پیوندهای مقصد در این راهنما برای رفتن مستقیم به صفحات کشور Roamify، مقایسه گزینههای طرح و تکمیل تسویه حساب قبل از حرکت استفاده کنید.
پلنهای پرطرفدار eSIM
مقصدهای منتخب برای سفر بعدی شما.
طرح های سیم کارت الکترونیکی ترکیه را بخرید
طرح های سیم کارت الکترونیکی تایلند را بخرید
طرح های سیم کارت الکترونیکی امارات متحده عربی را بخرید
طرح های سیم کارت الکترونیکی سنگاپور را بخرید
طرح های سیم کارت الکترونیکی استرالیا را بخرید
طرح های سیم کارت الکترونیکی مکزیک را بخریدراهی جای تازهای هستید؟ همان لحظه که فرود آمدید متصل بمانید.
اینترنت سفر مقرونبهصرفه برای بیش از ۲۰۰ مقصد. بدون هزینه رومینگ، بدون کارمزد پنهان، فقط اسکن کنید و راه بیفتید.
ادامه مطالعه
همه مقالهها
eSIM برای پرو: راهنمای کامل اتصال برای 2026
آیا در حال برنامهریزی سفر به پرو در سال 2026 هستید؟ در سراسر لیما، کوسکو، ماچو پیچو، دره مقدس و آمازون با یک eSIM بدون دردسر متصل بمانید. یاد بگیرید چگونه سازگاری دستگاه را بررسی کنید، طرح داده مناسب را انتخاب کنید، پوشش را بر اساس منطقه درک کنید و بین eSIM و SIM محلی تصمیم بگیرید. کشف کنید چرا eSIM های مقرون به صرفه و فقط داده Roamify (از 2 دلار) برای مسافرانی که میخواهند بلافاصله پس از ورود فعال شوند، بدون هزینههای رومینگ و دادههای موبایل قابل اعتماد در سراسر پرو ایدهآل هستند.
Marissa Ling 
eSIM برای عربستان سعودی: چگونه به عنوان یک بازدیدکننده در سال 2026 متصل بمانید
آیا در حال برنامهریزی سفر به عربستان سعودی در سال 2026 هستید؟ با استفاده از یک eSIM مسافرتی، از رومینگ گرانقیمت و صفهای سیمکارت در فرودگاه صرفنظر کنید. این راهنما سازگاری eSIM، پوشش STC، موبایلی و زین، دسترسی 4G/5G در ریاض، جده، مکه، مدینه و العلا، مقدار دادهای که واقعاً نیاز دارید و مراحل تنظیم eSIM قبل از پرواز را توضیح میدهد. ارائهدهندگان پیشرو مانند Roamify، Airalo و Holafly را مقایسه کنید، درباره استفاده از VPN و اپلیکیشنها (واتساپ، تلگرام، شبکههای اجتماعی) بیاموزید و نکات عملی برای متصل ماندن بهطور روان در طول حج، عمره، سفرهای کاری یا تفریحی در عربستان سعودی دریافت کنید.
Michael Harbour
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 Bogle