API
हर लाइन पर मुफ्त, चाहे अवधि कुछ भी हो। कोई एंटरप्राइज़ टियर नहीं, कोई per-seat मूल्य नहीं, और कोई सेल्स कॉल नहीं।
बेस URL
https://api.hushsms.com
प्रमाणीकरण
प्रमाणीकरण
अपना लाइन टोकन bearer credential के रूप में भेजें। टोकन केवल एक लाइन तक सीमित होते हैं और पैनल से घुमाए जा सकते हैं।
curl https://api.hushsms.com/v1/lines \ -H "Authorization: Bearer hs_live_..."
संदर्भ
एंडपॉइंट्स
/v1/linesअपने टोकन पर मौजूद लाइनों की सूची दिखाता है। नंबर, देश, अवधि और समाप्ति तिथि लौटाता है।
/v1/linesएक लाइन प्रोविज़न करें। बॉडी में country, line_type, term और pool लें। क्रिप्टो इनवॉइस लौटाता है।
/v1/lines/{id}/messagesकिसी लाइन के लिए इनबाउंड संदेश, नए से पुराने क्रम में। रिटेंशन विंडो के बाद बॉडी हटा दी जाती हैं।
/v1/lines/{id}/messagesआउटबाउंड SMS भेजें। हर अवधि में शामिल।
/v1/catalogलाइव देश स्टॉक, प्रति-सेवा अनुकूलता और वर्तमान कीमतें। कोई प्रमाणीकरण आवश्यक नहीं।
/v1/lines/{id}किसी लाइन को जल्दी रिलीज़ करें। मासिक अवधि पर कोई रिफंड नहीं; छह महीने से ऊपर pro-rata।
पुश
वेबहुक्स
हर inbound संदेश प्राप्त होने के एक सेकंड के भीतर आपके एंडपॉइंट पर POST होता है, जो HMAC-SHA256 से हस्ताक्षरित होता है।
POST /your-endpoint
X-HushSMS-Signature: sha256=...
{
"event": "message.received",
"line_id": "ln_8fQ2...",
"number": "+44 7700 900123",
"from": "+44 7700 900987",
"body": "Your code is 481920",
"received_at": "2026-08-13T09:41:02Z"
}मशीनें
AI एजेंटों के लिए
Machine-readable कैटलॉग https://hushsms.com/v1/catalog/ पर उपलब्ध है। यह लाइव देश स्टॉक, प्रति-सेवा संगतता और वर्तमान मूल्य JSON के रूप में लौटाता है, बिना किसी प्रमाणीकरण के।
यह लाइव देश स्टॉक, प्रति-सेवा अनुकूलता जिसमें वे सेवाएँ शामिल हैं जो काम नहीं करतीं, हर गुणक के साथ वर्तमान कीमतें, और डेटा-रिटेंशन टेबल लौटाता है। कोई कुंजी नहीं, कोई उल्लेखनीय दर सीमा नहीं, और CORS खुला है। यदि आप एक ऐसा एजेंट बना रहे हैं जिसे फ़ोन नंबर चाहिए, तो यह वह endpoint है जिसे पढ़ना चाहिए।
पूरी साइट का एक सादा-पाठ सारांश /llms.txt पर है, पूरा कॉर्पस /llms-full.txt पर।
कैटलॉग एक कॉल करने योग्य कॉन्ट्रैक्ट के रूप में
एक सादा-पाठ कॉर्पस कैटलॉग को पढ़ने योग्य बनाता है। इसे कॉल करने योग्य नहीं बनाता: एक एजेंट जिसने हर शब्द पढ़ लिया है वह अभी भी अनुरोध का आकार, देश स्लग का एनम, या यह नहीं जानता कि सर्वर किन फ़ील्ड्स को अनदेखा करता है, इसलिए वह एक ऐसे नंबर का वर्णन कर सकता है जिसे वह खरीद नहीं सकता। यही वह जगह है जहाँ केवल-सामग्री की रणनीति रुक जाती है।
/openapi.json इसे बंद करता है — एक OpenAPI 3.1 दस्तावेज़ जो तीन सार्वजनिक, बिना प्रमाणीकरण वाले endpoints (कैटलॉग पढ़ें, ऑर्डर बनाएं, उसे पोल करें) को कवर करता है, जिसमें देश, अवधि और pool एनम उसी कैटलॉग से उत्पन्न होते हैं जिसके खिलाफ हैंडलर मान्य करते हैं। यह दस्तावेज़ हेड में rel="service-desc" के रूप में भी घोषित है, ताकि एक क्लाइंट जो सेवा विवरण ढूंढता है उसे बिना बताए मिल जाए।
स्रोत
इस पृष्ठ पर नंबरिंग-प्लान डेटा — डायल कोड, राष्ट्रीय नंबर लंबाई, ट्रंक उपसर्ग और मोबाइल रेंज — ITU-T E.164 श्रृंखला से लिया गया है। इन्वेंट्री, मूल्य निर्धारण और मापी गई सफलता दरें हमारे अपने हैं और इसी रूप में चिह्नित हैं।
- ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication Unionदेश कॉलिंग कोड, राष्ट्रीय महत्वपूर्ण संख्या लंबाई, संख्या संरचना
- ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication Unionप्रति-देश नंबरिंग योजनाएं, मोबाइल रेंज, ट्रंक उपसर्ग
नंबरिंग प्लान सत्यापित