تغييرات هامة في واجهة برمجة تطبيقات 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. البلد و رمز البلد الآن لهما معاني مميزة #
في السابق، قد تم استخدام هذه الحقول بالتبادل. الآن تخدم أغراضًا مختلفة و يجب أن تستخدم كلاهما قيمًا مستمدة من GET /api/esim/countries نقطة النهاية — لم تعد السلاسل العشوائية مقبولة.
| معامل | القيمة المقبولة | المصدر |
|---|---|---|
| البلد | الاسم الكامل للبلد | حقل الاسم من واجهة برمجة تطبيقات الدول |
| countryCode | رمز الدولة ISO | حقل الرمز من واجهة برمجة تطبيقات الدول |
الإجراء المطلوب: إذا كنت تمر حاليًا بسلاسل نصية حرة للبلد، قم بتحديث تكامل الخاص بك لاستدعاء 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 | سلسلة | مطلوب | ICCID الخاصة بـ eSIM التي سيتم إرسال الرسالة القصيرة إليها. |
| رسالة | سلسلة | مطلوب | محتوى الرسالة المراد إرساله. |
نقاط النهاية المحدثة #
POST /api/esim/apply — startDate مدعوم الآن #
تم إضافة حقل اختياري جديد startDate إلى نقطة نهاية إنشاء ملف تعريف eSIM. بالنسبة لمجموعة صغيرة من الحزم (~30 من 28,000+)، هذا الحقل هو مطلوب.
يمكنك تحديد هذه الحزم من خلال التحقق مما إذا كان requirements.travelDate هو صحيح في كائن الحزمة. إذا كان مطلوبًا ولم يتم توفيره، ستفشل طلب إنشاء الملف الشخصي.
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| startDate | سلسلة | شرطية | تاريخ بدء السفر بتنسيق ISO 8601. مطلوب إذا كانت requirements.travelDate صحيحة. |
تذكير المهلة
مرجع API الكامل #
التوثيق الكامل متاح على docs.getroamify.com.
إذا كان لديك أي أسئلة أو تحتاج إلى مساعدة في تحديث تكاملك، تواصل مع فريق دعم الشركاء لدينا.
خطط وجهات eSIM ذات الصلة
الأسئلة المتداولة
- ما الذي سأتعلمه في تغييرات هامة في واجهة برمجة تطبيقات eSIM الخاصة بـ Roamify؟
- سوف تتعلم كيفية عمل تنشيط eSIM، وكيفية مقارنة خطط البيانات، وخطوات الإعداد الأكثر أهمية قبل وأثناء رحلتك.
- كيف أختار خطة eSIM المناسبة لـ اليابان؟
- قم بمطابقة خطتك مع طول الرحلة والاستخدام اليومي المتوقع للبيانات واحتياجات نقطة الاتصال وجودة الشبكة في وجهتك. عادةً ما تحتاج الإقامات القصيرة إلى بيانات أقل، بينما يحتاج العمل عن بعد ومكالمات الفيديو إلى المزيد.
- أين يمكنني شراء خطط eSIM للسفر في اليابان وتايلاند؟
- استخدم روابط الوجهة في هذا الدليل للانتقال مباشرة إلى صفحات البلدان Roamify، ومقارنة خيارات الخطة، وإكمال عملية الدفع قبل المغادرة.