SMS4You सार्वजनिक एपीआई का परिचय: एसएमएस रिसेप्शन और नंबर प्रबंधन को स्वचालित करें
हम यह घोषणा करते हुए उत्साहित हैं कि आप में से कई लोग जिस चीज़ का इंतज़ार कर रहे थे, वह अब आ गई है—SMS4You सार्वजनिक API। अब, आपके खाते में जो कुछ भी आप मैन्युअल रूप से करते थे, वह प्रोग्रामेटिक रूप से किया जा सकता है: नंबर खरीदना, SMS और ईमेल से कोड प्राप्त करना, और अपने बैलेंस और दरों को ट्रैक करना। आपकी स्क्रिप्ट्स, बॉट्स और पंजीकरण सिस्टम SMS4You के साथ सीधे काम कर सकती हैं—बिना एक भी क्लिक के।
नीचे, हम विस्तार से बताएँगे कि हमने क्या जारी किया है, आपको इसकी आवश्यकता क्यों है, और पाँच मिनट में शुरुआत कैसे करें।
एक नज़र में प्रमुख विशेषताएँ
OTP सक्रियण (SMS प्राप्ति) और ईमेल सक्रियण के लिए एक पूर्ण-सुविधा संपन्न REST API।
देशों, सेवाओं और वर्तमान कीमतों की एक सूची—आपके खाते में जो कुछ भी दिखाई देता है, वह API के माध्यम से भी उपलब्ध है।
वेबहूक्स: कोड और स्थिति अपडेट स्वचालित रूप से आपके सर्वर पर भेजे जाते हैं, जिसके लिए लगातार पोलिंग की आवश्यकता नहीं होती।
SMS-Activate प्रोटोकॉल के साथ संगतता: केवल एक पता बदलकर मौजूदा इंटीग्रेशन को पोर्ट करें।
एक टोकन के माध्यम से सरल प्रमाणीकरण जिसे आप अपने खाते में स्वयं बनाते हैं।
आपके ब्राउज़र में सीधे अनुरोधों का परीक्षण करने की क्षमता के साथ इंटरैक्टिव दस्तावेज़ीकरण।
आपको एपीआई की आवश्यकता क्यों है
जब केवल कुछ ही सक्रियण होते हैं तो मैन्युअल रूप से नंबर खरीदना अच्छा काम करता है। लेकिन जैसे ही आप दसियों या सैकड़ों पंजीकरणों, थोक प्रसंस्करण, या अपने स्वयं के उत्पाद में एसएमएस रिसेप्शन को एकीकृत करने का काम करते हैं, तो इंटरफ़ेस में क्लिक करना बोझिल हो जाता है। एपीआई ठीक इसी समस्या का समाधान करती है: आप कोड में लॉजिक एक बार परिभाषित करते हैं, और बाकी सब कुछ स्वचालित रूप से हो जाता है, किसी भी पैमाने पर और दिन के किसी भी समय।
जिन सामान्य परिदृश्यों के लिए हमने इसे बनाया है:
आपके सॉफ़्टवेयर में स्वचालित खाता पंजीकरण और सत्यापन;
बल्क प्रोसेसिंग और परीक्षण जिनके लिए लगातार बड़ी संख्या में फोन नंबरों की आवश्यकता होती है;
एसएमएस कोड रिसेप्शन को सीधे अपनी सेवा या उत्पाद में एकीकृत करना;
मूल रूप से अन्य प्रदाताओं के लिए बनाए गए मौजूदा इंटीग्रेशन को माइग्रेट करना।
एपीआई क्या कर सकता है
1. टर्नकी सक्रियण: एक नंबर खरीदने से लेकर कोड प्राप्त करने तक
पूरा सक्रियण जीवनचक्र सहज REST एंडपॉइंट्स के माध्यम से सुलभ है:
एक सेवा और देश चुनें, उपलब्धता और कीमत जांचें;
एक ही अनुरोध से नंबर खरीदें;
प्राप्त एसएमएस (या ईमेल, यदि यह ईमेल सक्रियण है) प्राप्त करें;
पूरा करें, रद्द करें, या दोबारा SMS का अनुरोध करें—स्थिति पर आपका पूरा नियंत्रण होता है।
दोनों प्रमुख उत्पाद समर्थित हैं: SMS प्राप्ति (OTP) और ईमेल सक्रियण। प्रत्येक सक्रियण का एक अद्वितीय पहचानकर्ता होता है जिसका उपयोग आप बाद में संदर्भित करने के लिए करते हैं।
2. वर्तमान कैटलॉग और कीमतें
API वास्तविक समय का डेटा प्रदान करती है:
फ़ोन कोड के साथ देशों की सूची;
सेवाओं की एक सूची (SMS और ईमेल के लिए);
किसी विशिष्ट सेवा या देश के लिए कीमतें, साथ ही पेज-दर-पेज परिणामों के साथ एक संपूर्ण मूल्य सूची।
महत्वपूर्ण नोट: कीमतें आपकी व्यक्तिगत छूट लागू करके लौटाई जाती हैं। जो आप API प्रतिक्रिया में देखते हैं, वही आपके बैलेंस से कटौती की जाएगी।
3. वेबहुक्स: कोड स्वचालित रूप से आपके पास आते हैं
एसएमएस संदेशों की प्रतीक्षा करते समय सर्वर को लगातार पोल करना व्यर्थ और धीमा है। इसीलिए SMS4You वेबहुक्स प्रदान करता है: जैसे ही कोई नया संदेश आता है या सक्रियण स्थिति बदलती है, हम आपके द्वारा निर्दिष्ट पतों पर स्वचालित रूप से एक HTTP अनुरोध भेजते हैं।
आप बिना पोलिंग के, तुरंत इवेंट्स प्राप्त करते हैं;
प्रत्येक अनुरोध HMAC हस्ताक्षर के साथ साइन किया जाता है, ताकि आप सत्यापित कर सकें कि अनुरोध वास्तव में हमसे ही है;
यदि आपका सर्वर अस्थायी रूप से अनुपलब्ध है तो हम पुनः प्रयास तंत्र लागू करते हैं;
जो लोग व्हाइटलिस्ट के माध्यम से इनकमिंग ट्रैफ़िक को सीमित करते हैं, उनके लिए हम आईपी पतों की एक सूची प्रकाशित करते हैं जिनसे वेबहुक्स भेजे जाते हैं।
REST API के साथ मिलकर, यह एकीकरण पूरा करता है: आप स्वयं अनुरोध भेजते हैं और एक पुश चैनल के माध्यम से अपडेट प्राप्त करते हैं।
4. SMS-Activate के साथ संगतता: बिना फिर से लिखे माइग्रेशन
यह कुछ ऐसा है जिस पर हमें विशेष रूप से गर्व है। यदि आपके पास पहले से SMS-Activate API के आसपास बनाया गया सॉफ़्टवेयर है, तो आपको अपने इंटीग्रेशन को फिर से लिखने की आवश्यकता नहीं है। SMS4You एक संगत प्रोटोकॉल का समर्थन करता है: बस सर्वर पते को हमारे पते में बदलें और अपनी कुंजी को प्रतिस्थापित करें।
आपका मौजूदा कोड, लाइब्रेरी और बॉट वैसे ही काम करते रहेंगे, लेकिन अब SMS4You के फोन नंबर, मूल्य निर्धारण और गुणवत्ता के साथ। यह हमें स्विच करना आपकी कॉन्फ़िग फ़ाइल में एक ही लाइन का काम बना देता है, न कि हफ्तों के विकास का।
5. सुरक्षित और सरल प्रमाणीकरण
आपकी स्क्रिप्ट्स में कोई यूज़रनेम या पासवर्ड नहीं। अपने खाते में लॉग इन करें, API टोकन टैब में एक व्यक्तिगत टोकन बनाएँ, और इसे अपनी रिक्वेस्ट्स में उपयोग करें। आप टोकन को तीन तरीकों से पास कर सकते हैं—अपनी लाइब्रेरी के लिए सबसे सुविधाजनक तरीका चुनें:
हेडर में
Authorization: Bearer <api token>;हेडर
X-Api-Token: <api token>;एक क्वेरी पैरामीटर के रूप में
?api_token=<api token>.
आप कई टोकन बना सकते हैं (उदाहरण के लिए, प्रत्येक प्रोजेक्ट के लिए एक अलग टोकन) और दूसरों को प्रभावित किए बिना किसी भी समय एक समझौता किए गए टोकन को रद्द कर सकते हैं। टोकन मान केवल एक बार तब प्रदर्शित होता है जब इसे बनाया जाता है—उसके बाद, यह केवल आपके द्वारा संग्रहीत किया जाता है।
6. व्यावहारिक दस्तावेज़ीकरण
हमने OpenAPI पर आधारित इंटरैक्टिव दस्तावेज़ीकरण तैयार किया है: प्रत्येक एंडपॉइंट का वर्णन किया गया है, प्रत्येक फ़ील्ड का प्रकार निर्दिष्ट किया गया है, और आप टर्मिनल खोले बिना सीधे पेज से अनुरोध चला सकते हैं। वेबहुक्स और SMS-Activate के साथ संगत प्रोटोकॉल पर एक अलग अनुभाग भी है।
दस्तावेज़ीकरण docs.sms4you.org पर उपलब्ध है।
पाँच मिनट में शुरू करें
बेस एपीआई यूआरएल: https://api.sms4you.org/api/v1
चरण 1. अपने खाते की शेष राशि और छूट की जाँच करें
curl https://api.sms4you.org/api/v1/me \
-H "Authorization: Bearer YOU TOKEN"
{
"data": {
"name": "Ivan",
"email": "[email protected]",
"email_verified": true,
"balance": "12.3456",
"currency": "USD",
"discount_percent": 5
}
}
चरण 2. वांछित सेवा की कीमत की जाँच करें
curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
-H "Authorization: Bearer YOU TOKEN"
चरण 3. एक नंबर खरीदें
curl -X POST https://api.sms4you.org/api/v1/activations \
-H "Authorization: Bearer YOU TOKEN" \
-H "Content-Type: application/json" \
-d '{"service_id": 123, "country_id": 7, "price": "0.20"}'
प्रतिक्रिया में फोन नंबर और एक सक्रियण कोड शामिल होगा।
चरण 4. प्राप्त एसएमएस प्राप्त करें
curl https://api.sms4you.org/api/v1/activations/{ACTIVATION_ID}/messages \
-H "Authorization: Bearer YOU TOKEN"
और यदि आप एक वेबहुक सेट करते हैं, तो आपको यह चरण करने की भी आवश्यकता नहीं होगी—कोड आपको स्वचालित रूप से भेज दिया जाएगा।
सीमाएँ और विश्वसनीयता
सभी अनुरोधों की आवृत्ति सीमित होती है (डिफ़ॉल्ट रूप से प्रति मिनट 120 अनुरोध तक), ताकि यह सुनिश्चित हो सके कि सेवा सभी के लिए स्थिर बनी रहे।
सभी प्रतिक्रियाएँ एक समान प्रारूप में आती हैं, जिसमें त्रुटि संदेश भी शामिल हैं: एक स्पष्ट कोड, एक मानव-पठनीय संदेश, और, यदि आवश्यक हो, विवरण। कोड में इन्हें संसाधित करना बहुत आसान है।
खरीदारी के लिए एक सत्यापित ईमेल पता आवश्यक है—यह एक मानक सुरक्षा उपाय है।
यह किसके लिए है
विकासकर्ता जिन्हें अपने उत्पाद के भीतर SMS संदेश प्राप्त करने की आवश्यकता है।
आर्बिट्रेज और मार्केटिंग टीमें जहाँ पंजीकरण लगातार आते रहते हैं।
फोन सत्यापन से संबंधित परिदृश्यों का परीक्षण करने वाली QA टीमें।
जो कोई भी पहले से SMS-Activate-संगत सॉफ़्टवेयर का उपयोग करता है और माइग्रेशन की झंझट के बिना एक प्रदाता चाहता है।
आगे क्या
सार्वजनिक API वह नींव है जिस पर हम आगे निर्माण करते रहेंगे। हम आपकी अनुरोधों को सुनकर अपने उत्पाद की कवरेज और क्षमताओं का विस्तार करने की योजना बना रहे हैं। यदि आपको कोई विशिष्ट एंडपॉइंट या परिदृश्य नहीं मिल रहा है, तो सपोर्ट चैट के माध्यम से हमसे संपर्क करें: हम सब कुछ पढ़ते हैं और वास्तव में आवश्यक चीज़ों को प्राथमिकता देते हैं।
इसे अभी आज़माएँ:
अपने खाते में लॉग इन करें और API टोकन टैब में एक टोकन बनाएँ।
docs.sms4you.org पर दस्तावेज़ खोलें।
अपनी पहली रिक्वेस्ट करें—और बाकी को स्वचालित करें।
एकीकरण का आनंद लें, और आशा है कि आपके कोड समय पर आएँ।
