تغييرات هامة في واجهة برمجة تطبيقات eSIM الخاصة بـ Roamify
اكتشف أحدث تحديثات واجهة برمجة تطبيقات 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. البلد و رمز البلد الآن لهما معاني مميزة #
في السابق، قد تم استخدام هذه الحقول بالتبادل. الآن تخدم أغراضًا مختلفة و يجب أن تستخدم كلاهما قيمًا مستمدة من 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، وكيفية مقارنة خطط البيانات، وخطوات الإعداد الأكثر أهمية قبل وأثناء رحلتك.
قم بمطابقة خطتك مع طول الرحلة والاستخدام اليومي المتوقع للبيانات واحتياجات نقطة الاتصال وجودة الشبكة في وجهتك. عادةً ما تحتاج الإقامات القصيرة إلى بيانات أقل، بينما يحتاج العمل عن بعد ومكالمات الفيديو إلى المزيد.
استخدم روابط الوجهة في هذا الدليل للانتقال مباشرة إلى صفحات البلدان Roamify، ومقارنة خيارات الخطة، وإكمال عملية الدفع قبل المغادرة.
باقات eSIM الشائعة
وجهات مختارة بعناية لرحلتك القادمة.
اشترِ خطط eSIM في تركيا
اشترِ خطط eSIM في تايلاند
اشترِ خطط eSIM في الإمارات العربية المتحدة
اشترِ خطط eSIM في سنغافورة
اشترِ خطط eSIM في أستراليا
اشترِ خطط eSIM في المكسيكمتجه إلى وجهة جديدة؟ ابقَ متصلاً لحظة وصولك.
بيانات سفر بأسعار معقولة لأكثر من 200 وجهة. بلا رسوم تجوال، وبلا رسوم خفية، فقط امسح وانطلق.
تابع القراءة
كل المقالات
eSIM في بيرو: الدليل الشامل للاتصال لعام 2026
تخطط لرحلة إلى بيرو في عام 2026؟ ابق متصلاً عبر ليما، كوسكو، ماتشو بيتشو، وادي المقدس، والأمازون مع eSIM خالية من المتاعب. تعلم كيفية التحقق من توافق الجهاز، اختيار خطة البيانات المناسبة، فهم التغطية حسب المنطقة، واتخاذ القرار بين eSIM وSIM محلي. اكتشف لماذا تعتبر eSIMs فقط للبيانات من Roamify (ابتداءً من 2 دولار) مثالية للمسافرين الذين يرغبون في تفعيل فوري عند الوصول، بدون رسوم تجوال، وبيانات موبايل موثوقة في جميع أنحاء بيرو.
Marissa Ling 
eSIM للسعودية: كيف تبقى متصلاً كزائر في 2026
تخطط لرحلة إلى السعودية في 2026؟ تجنب التجوال المكلف وطوابير بطاقات SIM في المطار باستخدام eSIM للسفر. يشرح هذا الدليل توافق eSIM، التغطية على STC وMobily وZain، توفر 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