संगत API

API आपके सॉफ़्टवेयर और हमारे सक्रियण सर्वर के बीच बातचीत का प्रोटोकॉल है। आपकी ओर से SMS प्राप्त करने की प्रक्रिया को स्वचालित करने के लिए API की आवश्यकता है। API के साथ काम करने के लिए आपको अपनी API कुंजी का उपयोग करना होगा, आप इसे एक सरल पंजीकरण प्रक्रिया पूरी करके अपने प्रोफ़ाइल अनुभाग में प्राप्त कर सकते हैं। हमारा API प्रतियोगी वेबसाइटों के साथ पूरी तरह से संगत है।

API प्रोटोकॉल विवरण

सभी अनुरोधों को https://api.sms-man.com/stubs/handler_api.php POST या GET अनुरोध पर जाना चाहिए। सभी अनुरोधों में पैरामीटर के रूप में API कुंजी होनी चाहिए api_key JSON प्रारूप में सभी उत्तर

शेष राशि अनुरोध

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getBalance`
`api_key`	String	हाँ	आपकी API कुंजी

परिणाम

ACCESS_BALANCE:$balance (जहां $balance आपके खाते की शेष राशि है)

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी

वर्तमान मूल्य प्राप्त करें

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getPrices`
`api_key`	String	हाँ	आपकी API कुंजी
`country`	Number	नहीं
`service`	String	नहीं

परिणाम

{
  "0": {"vk":{"cost":"15","count":6455},"wb":{"cost":"50","count":124}},
  "1": {"fb":{"cost":"6","count":1000}}
}

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी

नंबर प्राप्त करना

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getNumber`
`api_key`	String	हाँ	आपकी API कुंजी
`country`	Number	हाँ
`service`	String	हाँ
`maxPrice`	Number	नहीं	आपका वांछित मूल्य
`currency`	String	नहीं	`RUB/USD/EUR`
`ref`	String	नहीं	रेफरल ID पास करें

परिणाम

ACCESS_NUMBER:$id:$number
$id - सक्रियण ID
$number - फोन नंबर

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी
`NO_NUMBERS`	कोई नंबर नहीं, बाद में फिर से प्रयास करें
`NO_BALANCE`	कम शेष

सक्रियण की स्थिति प्राप्त करें

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getStatus`
`api_key`	String	हाँ	आपकी API कुंजी
`id`	Number	हाँ	सक्रियण ID

परिणाम

STATUS_WAIT_CODE - लंबित SMS
STATUS_WAIT_RETRY:$lastcode - कोड शोधन की प्रतीक्षा (जहां $lastcode - अंतिम, विफल कोड)
STATUS_WAIT_RESEND — एक SMS के पुनः भेजे जाने की प्रतीक्षा कर रहा है (सॉफ्टवेयर को SMS को पुनः भेजना चाहिए और स्टेटस का एक परिवर्तन 6 तक करना चाहिए)
STATUS_CANCEL — सक्रियण रद्द कर दिया गया है
STATUS_OK:$code — प्राप्त कोड (जहां $code सक्रियण कोड है)

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी
`NO_ACTIVATION`	कोई सक्रियता नहीं है

सक्रियण की स्थिति प्राप्त करें V2

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getStatusV2`
`api_key`	String	हाँ	आपकी API कुंजी
`id`	Number	हाँ	सक्रियण ID

परिणाम

{
  "verificationType": 0,
  "sms": {"dateTime":"0000-00-00 00:00:00","code":"code","text":"sms text"}
}

STATUS_CANCEL

STATUS_WAIT_CODE

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी
`NO_ACTIVATION`	कोई सक्रियता नहीं है

सक्रियण की स्थिति बदलें

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`setStatus`
`api_key`	String	हाँ	आपकी API कुंजी
`id`	Number	हाँ	सक्रियण ID
`status`	Number	हाँ	सक्रियता स्थिति

संभव स्थिति

-1 — सक्रियण रद्द करें
1 — सूचित करें कि SMS भेजा गया है (वैकल्पिक)
3 — एक और कोड का अनुरोध करें
6 — सक्रियण को पूरा करें (यदि स्थिति "कोड प्राप्त" थी - सफलता को चिह्नित करता है और पूरा करता है, यदि स्थिति "तैयारी" थी - हटा देता है और त्रुटि अंकित करता है, यदि स्थिति "रिपीट के लिए प्रतीक्षा" थी - सक्रियण को SMS की प्रतीक्षा में बदल देता है)
8 — सूचित करता है कि संख्या का उपयोग किया जाता है और सक्रियण को रद्द कर देता है

परिणाम

ACCESS_READY - संख्या की तत्परता की पुष्टि की जाती है
ACCESS_RETRY_GET - एक नए SMS की प्रतीक्षा में
ACCESS_ACTIVATION - सेवा सफलतापूर्वक सक्रिय है
ACCESS_CANCEL - सक्रियण रद्द कर दिया जाता है
EARLY_CANCEL_DENIED - पहले 2 मिनट के भीतर नंबर को रद्द करने की अनुमति नहीं है।

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी
`NO_ACTIVATION`	सक्रियण ID मौजूद नहीं है
`BAD_STATUS`	गलत स्थिति

सभी देशों की सूची प्राप्त करें

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getCountries`
`api_key`	String	हाँ	आपकी API कुंजी

परिणाम

[
  {"id":0,"name":"Россия","name_en":"Russia"},
  {"id":3,"name":"Китай","name_en":"China"}
]

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी

सभी सेवाओं की सूची प्राप्त करें

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	मान
`action`	String	हाँ	`getServices`
`api_key`	String	हाँ	आपकी API कुंजी

परिणाम

[
  {"id":"vk","name":"Вконтакте"},
  {"id":"wb","name":"WeChat"},
  {"id":"tg","name":"Telegram"}
]

संभावित त्रुटियां

गलती	विवरण
`BAD_KEY`	गलत API कुंजी
`BAD_ACTION`	गलत कार्रवाई