تغییرات شکستن API eSIM Roamify
Donald Bogle
June 9, 2026 22:20
ما در حال ارائه مجموعهای از بهروزرسانیهای 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.
اگر سوالی دارید یا به کمک در بهروزرسانی یکپارچگی خود نیاز دارید، با تیم پشتیبانی شریک ما تماس بگیرید.
سوالات متداول
- در تغییرات شکستن API eSIM Roamify چه خواهم آموخت؟
- یاد خواهید گرفت که فعالسازی eSIM چگونه کار میکند، چگونه برنامههای داده را مقایسه کنید، و کدام مراحل راهاندازی قبل و در طول سفرتان مهمتر است.
- چگونه طرح eSIM مناسب برای ژاپن را انتخاب کنم؟
- برنامه خود را با طول سفر، مصرف روزانه داده مورد انتظار، نیازهای نقطه اتصال و کیفیت شبکه در مقصد مطابقت دهید. اقامت های کوتاه معمولاً به داده کمتری نیاز دارد، در حالی که کار از راه دور و تماس های ویدیویی به اطلاعات بیشتری نیاز دارند.
- از کجا میتوانم برنامههای eSIM سفر برای ژاپن و تایلند بخرم؟
- از پیوندهای مقصد در این راهنما برای رفتن مستقیم به صفحات کشور Roamify، مقایسه گزینههای طرح و تکمیل تسویه حساب قبل از حرکت استفاده کنید.