Roamify eSIM API में महत्वपूर्ण परिवर्तन
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 endpoint — मनमाने स्ट्रिंग्स अब स्वीकार नहीं किए जाते।
| Parameter | स्वीकृत मान | Source |
|---|---|---|
| देश | पूर्ण देश का नाम | Country API से नाम फ़ील्ड |
| countryCode | ISO देश कोड | Country API से कोड फ़ील्ड |
Action required: यदि आप वर्तमान में फ्री-टेक्स्ट देश स्ट्रिंग्स पास कर रहे हैं, तो अपने इंटीग्रेशन को अपडेट करें ताकि पहले कॉल करें 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
एक eSIM पर सीधे एक SMS संदेश भेजें।
| नाम | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
| iccid | स्ट्रिंग | आवश्यक | SMS भेजने के लिए eSIM का ICCID। |
| संदेश | स्ट्रिंग | आवश्यक | भेजने के लिए संदेश सामग्री। |
अपडेटेड एंडपॉइंट्स #
POST /api/esim/apply — startDate अब समर्थित है #
एक नया वैकल्पिक startDate फ़ील्ड Generate eSIM Profile एंडपॉइंट में जोड़ा गया है। कुछ पैकेजों के छोटे सेट (~30 में से 28,000+) के लिए, यह फ़ील्ड आवश्यक है।
आप इन पैकेजों की पहचान कर सकते हैं यदि requirements.travelDate है सत्य पैकेज ऑब्जेक्ट में। यदि आवश्यक हो और प्रदान नहीं किया गया हो, तो प्रोफ़ाइल जनरेशन अनुरोध विफल हो जाएगा।
| नाम | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
| शुरुआत तिथि | स्ट्रिंग | शर्तीय | यात्रा की प्रारंभ तिथि ISO 8601 प्रारूप में। आवश्यक है यदि requirements.travelDate सत्य है। |
टाइमआउट अनुस्मारक
पूर्ण API संदर्भ #
पूर्ण दस्तावेज़ यहाँ उपलब्ध है docs.getroamify.com.
यदि आपके कोई प्रश्न हैं या अपने एकीकरण को अपडेट करने में मदद की आवश्यकता है, तो हमारी साझेदार समर्थन टीम से संपर्क करें।
संबंधित eSIM गंतव्य योजनाएं
अक्सर पूछे जाने वाले प्रश्नों
- मैं Roamify eSIM API में महत्वपूर्ण परिवर्तन में क्या सीखूंगा?
- आप सीखेंगे कि eSIM सक्रियण कैसे काम करता है, डेटा प्लान की तुलना कैसे करें और आपकी यात्रा से पहले और उसके दौरान कौन से सेटअप चरण सबसे अधिक मायने रखते हैं।
- मैं जापान के लिए सही eSIM प्लान कैसे चुनूं?
- अपनी योजना का मिलान यात्रा की लंबाई, अपेक्षित दैनिक डेटा उपयोग, हॉटस्पॉट आवश्यकताओं और अपने गंतव्य पर नेटवर्क गुणवत्ता से करें। छोटे प्रवास के लिए आमतौर पर कम डेटा की आवश्यकता होती है, जबकि दूरस्थ कार्य और वीडियो कॉल के लिए अधिक डेटा की आवश्यकता होती है।
- मैं जापान और थाईलैंड के लिए यात्रा eSIM योजनाएँ कहाँ से खरीद सकता हूँ?
- Roamify देश के पेजों पर सीधे जाने, योजना विकल्पों की तुलना करने और प्रस्थान से पहले चेकआउट पूरा करने के लिए इस गाइड में गंतव्य लिंक का उपयोग करें।