API प्रलेखन
API वह प्रोटोकॉल है जो आपके सॉफ़्टवेयर और हमारे सक्रियण सर्वर के बीच संचार की अनुमति देता है .
API आपके पक्ष पर SMS, OTP और PVA प्राप्त करने की प्रक्रिया को स्वचालित करने के लिए आवश्यक है।
हमारा API प्रतियोगी साइटों के साथ पूरी तरह संगत है।
सभी अनुरोध https://smsbower.page/stubs/handler_api.php पर POST या GET अनुरोध होने चाहिए।
सभी अनुरोधों में 'api_key' नामक API कुंजी होनी चाहिए
पैरामीटर $api_key - आपकी API कुंजी
उत्तर
ACCESS_BALANCE:खाता शेष
संभावित गलतियाँ
BAD_KEY - अमान्य API कुंजी
उत्तर
ACCESS_BALANCE:$yourBalance
umber&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
&phoneException=$phoneException&ref=$ref
&userID=$userID&minPrice=$minPrice
पैरामीटर $api_key - आपकी API कुंजी $service - सेवा तालिका देखें तालिका देखें $country - देश नंबर तालिका देखें $maxPrice - अधिकतम मूल्य जिसके लिए आप नंबर खरीदने को तैयार हैं $providerIds - खरीदारी के लिए प्रदाताओं की सूची, कॉमा से अलग (1,2,3) $exceptProviderIds - संख्या खरीद से बाहर प्रदाताओं की सूची, कॉमा से अलग (1,2,3) $phoneException - नंबर के लिए उपसर्ग को छोड़कर। कॉमा से अलग करें। रिकॉर्ड प्रारूप: देश कोड और 3 से 6 अंक का मास्क (जैसे 7918,7900111) $ref - रेफरल ID स्थानांतरित करें $userID - पुनर्विक्रेताओं के लिए नया पैरामीटर, विवरण के लिए कृपया समर्थन से संपर्क करें। $minPrice - वह न्यूनतम कीमत जिस पर आप नंबर खरीदने के लिए तैयार हैं। API के माध्यम से नंबर प्राप्त करके, आप परियोजना नियमों से सहमत होते हैं
उत्तर ACCESS_NUMBER:$activationId:$phoneNumber
संभावित गलतियाँ BAD_KEY - अमान्य API कुंजी BAD_ACTION - गलत कार्रवाई BAD_SERVICE - गलत सेवा नाम
पैरामीटर $api_key - आपकी API कुंजी $id - सक्रियण ID
उत्तर
STATUS_WAIT_CODE - एसएमएस का इंतज़ार है
STATUS_WAIT_RETRY:$lastCode - अगले एसएमएस का इंतजार
STATUS_CANCEL - सक्रियकरण रद्द किया गया
STATUS_OK: 'activation code' - कोड प्राप्त हुआ
संभावित गलतियाँ
BAD_KEY - अमान्य API कुंजी
BAD_ACTION - गलत कार्रवाई
NO_ACTIVATION - गलत सक्रियण ID
atus&status=$status&id=$id
API क्रोनोलॉजी की सरल लॉजिक:
getNumber मेथड से नंबर प्राप्त करें, इसके बाद निम्नलिखित क्रियाएं उपलब्ध हैं: 8 - सक्रियण रद्द करें (यदि नंबर आपके अनुकूल नहीं है) 1 - सूचित करें कि SMS भेजी गई है (वैकल्पिक)
स्थिति 1 वाले सक्रियण के लिए: 8 - सक्रियण रद्द करें
कोड प्राप्त करने के तुरंत बाद: 3 - एक और SMS अनुरोध करें 6 - SMS कोड की पुष्टि करें और सक्रियण पूरा करें
स्थिति 3 वाले सक्रियण के लिए: 6 - SMS कोड की पुष्टि करें और सक्रियण पूरा करें
उत्तर ACCESS_READY - नंबर SMS प्राप्त करने के लिए तैयार है ACCESS_RETRY_GET - नई SMS का इंतजार कर रहा है ACCESS_ACTIVATION - सेवा सफलतापूर्वक सक्रिय हो गई है ACCESS_CANCEL - सक्रियण रद्द कर दिया गया
संभावित गलतियाँ
NO_ACTIVATION - गलत सक्रियण ID
BAD_STATUS - गलत स्थिति
BAD_KEY - अमान्य API कुंजी
BAD_ACTION - गलत कार्रवाई
EARLY_CANCEL_DENIED - खरीद के 2 मिनट बाद नंबर को रद्द किया जा सकता है
rices&service=$service&country=$country
पैरामीटर $api_key - आपकी API कुंजी $service - सेवा का नाम (वैकल्पिक, डिफ़ॉल्ट रूप से सभी सेवाएं) तालिका देखें $country - कोड नाम (वैकल्पिक, डिफ़ॉल्ट रूप से सभी देश) तालिका देखें
उत्तर
JSON - इस प्रारूप में ऑब्जेक्ट
{''देश'':
{''सेवा'':
{
''cost'':लागत,'
'count'':गिनती
}
}
}
पैरामीटर $api_key - आपकी API कुंजी
उत्तर
JSON - इस प्रारूप में ऑब्जेक्ट
{
"status": "success",
"services": [
{
"code": "kt",
"name": "KakaoTalk"
}
]
}
पैरामीटर $api_key - आपकी API कुंजी
उत्तर
JSON - इस प्रारूप में ऑब्जेक्ट
{
{
"id": 1003
"rus": "Бермуды"
"eng": "Bermuda"
"chn": "百慕大"
}
}
opCountriesByService&service=$service
पैरामीटर $api_key - आपकी API कुंजी $service - name of the service तालिका देखें
विवरण
Returns top 10 countries for the specified service sorted by internal priority. For each country, the list of Gold-ranked partners is returned, sorted by sales count from best to worst.
उत्तर
JSON - इस प्रारूप में ऑब्जेक्ट
{
"देश": {
"Partner ID": {
"price": मूल्य,
"count": गिनती
}
}
}
प्रतिक्रिया का उदाहरण
{
"usa": {
"3170": {
"price": 0.12,
"count": 542
},
"4120": {
"price": 0.14,
"count": 301
}
},
"canada": {
"2211": {
"price": 0.11,
"count": 190
}
}
}
संभावित गलतियाँ
BAD_KEY - अमान्य API कुंजी
BAD_ACTION - गलत कार्रवाई
BAD_SERVICE - गलत सेवा नाम
यह मेथड getNumber की तरह काम करता है, समान पैरामीटर लेता है लेकिन अतिरिक्त सक्रियण जानकारी लौटाता है .
umberV2&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
&userID=$userID&minPrice=$minPrice
पैरामीटर api_key - आपकी API कुंजी $service - सेवा तालिका देखें तालिका देखें $country - देश नंबर तालिका देखें $maxPrice - अधिकतम मूल्य जिसके लिए आप नंबर खरीदने को तैयार हैं $providerIds - खरीदारी के लिए प्रदाताओं की सूची, कॉमा से अलग (1,2,3) $exceptProviderIds - संख्या खरीद से बाहर प्रदाताओं की सूची, कॉमा से अलग (1,2,3) $userID - पुनर्विक्रेताओं के लिए नया पैरामीटर, विवरण के लिए कृपया समर्थन से संपर्क करें। $minPrice - वह न्यूनतम कीमत जिस पर आप नंबर खरीदने के लिए तैयार हैं। API के माध्यम से नंबर प्राप्त करके, आप परियोजना नियमों से सहमत होते हैं
यदि अनुरोध सफल है, तो प्रतिक्रिया निम्न प्रारूप में होगी .
{
"activationId": "id",
"phoneNumber": number,
"activationCost": activationCost,
"countryCode": countryCode,
"canGetAnotherSms": canGetAnotherSms,
"activationTime": activationTime,
"activationOperator": activationOperator,
}
संभावित गलतियाँ BAD_KEY - अमान्य API कुंजी BAD_ACTION - गलत कार्रवाई BAD_SERVICE - गलत सेवा नाम
ricesV2&service=$service&country=$country
पैरामीटर api_key - आपकी API कुंजी $service - सेवा तालिका देखें $country - देश नंबर तालिका देखें
"देश": {
"सेवा": {
"मूल्य1": गिनती,
"मूल्य2": गिनती,
"मूल्य3": गिनती,
}
},
संभावित गलतियाँ BAD_KEY - अमान्य API कुंजी BAD_ACTION - गलत कार्रवाई BAD_SERVICE - गलत सेवा नाम
ricesV3&service=$service&country=$country
पैरामीटर api_key - आपकी API कुंजी $service - सेवा तालिका देखें $country - देश नंबर तालिका देखें
"देश": {
"सेवा": {
"provider 1 id": {
count: गिनती,
price: मूल्य,
provider_id: provider id,
},
"provider 2 id": {
count: गिनती,
price: मूल्य,
provider_id: provider id,
},
"provider 3 id": {
count: गिनती,
price: मूल्य,
provider_id: provider id,
},
}
},
संभावित गलतियाँ BAD_KEY - अमान्य API कुंजी BAD_ACTION - गलत कार्रवाई BAD_SERVICE - गलत सेवा नाम BAD_COUNTRY - गलत देश नाम
&network=$network
पैरामीटर api_key - आपकी API कुंजी $coin - coin (usdt, trx) $network - network number (tron)
{
"wallet_address": "TFGMAwTfxtxKvy1mTTHr7XJaXeumjdmhGg"
}
वेবহुक एक तंत्र है जो स्वचालित रूप से किसी सिस्टम को घटनाओं के बारे में सूचित करता है। नंबर प्राप्त करने के बाद, आने वाले एसएमएस संदेशों के लिए लगातार सर्वर से पूछताछ करने की कोई आवश्यकता नहीं है। हम आपकी सेटिंग में निर्दिष्ट पते (या एकाधिक पतों) पर उनकी सामग्री तुरंत भेज सकते हैं।
वेबहुक अनुरोधों के लिए आईपी एड्रेस
यह सुनिश्चित करने के लिए कि सूचनाएं सही ढंग से संचालित हों और उनके नुकसान से बचने के लिए, अपने सर्वर पर स्वीकृत स्रोतों की श्वेतसूची में निम्नलिखित आईपी एड्रेस जोड़ें:
सक्रियण और किराए के लिए वेबहुक निम्नलिखित एड्रेस से आएंगे:
सुनिश्चित करें कि आपका सर्वर इन आईपी से आने वाले अनुरोधों को स्वीकार करता है।
आने वाले एसएमएस सूचनाएं
यदि आपकी प्रोफ़ाइल में वेबहुक यूआरएल https://your-site.com/webhook.php निर्दिष्ट है, तो एसएमएस संदेश प्राप्त होने पर हम निम्नलिखित प्रारूप में उस पते पर एक POST अनुरोध करेंगे:
{
"activationId": 123456,
"service": "go",
"text": "Sms text",
"code": "12345",
"country": 2,
"receivedAt": "2023-01-01 12:00:00"
}
सर्वर प्रतिक्रिया
आपकी स्क्रिप्ट को 200 की HTTP स्थिति वापस करनी होगी।
- - यदि सर्वर प्रतिक्रिया नहीं करता है, तो 1 मिनट के बाद और फिर 5 मिनट के बाद 2 पुन: प्रयास अनुरोध किए जाएंगे।
- - 3 असफल प्रयासों की स्थिति में, आपको एक सूचना प्राप्त होगी और आपको अपनी profile में त्रुटियां दिखाई देंगी।
आप अपनी profile settings में वेबहुक को सक्षम या अक्षम कर सकते हैं।