$ USD $

प्राप्त संख्या क्वेरी आँकड़े शेष इतिहास सेटिंग्स रेफरल कार्यक्रम

Главная
साथी एपीआई प्रलेखन ग्रिजली एसएमएस

साथी एपीआई प्रलेखन ग्रिजली एसएमएस

Description of the protocol's operation

पार्टनर प्रोटोकॉल को एपीआई के माध्यम से सीधे ग्रिजली एसएमएस सर्वर पर फोन नंबर और आने वाले एसएमएस संदेश प्रदान करने के लिए डिज़ाइन किया गया है ।

सभी अनुरोधों में पैरामीटर-कुंजी शामिल है । यह कुंजी सहायक कर्मचारियों द्वारा प्रदान की जाती है और व्यक्तिगत खाते में उपलब्ध है ।

मात्रा अनुरोध GET_SERVICES, संख्या अनुरोध GET_NUMBER और सक्रियण पूर्णता अनुरोध FINISH_ACTIVATION सीधे हमारे सर्वर से पार्टनर के सर्वर पर भेजे जाते हैं ।

यूआरएल प्रारूप : https://GrizzlySMS जहां ग्रिजली हो सकती है partner.ru:port/GrizzlySMS.php or partner.ru/GrizzlySMS.php

GET_SERVICES

GET_NUMBER

PUSH_SMS

FINISH_ACTIVATION

ग्रिजली एसएमएस सर्वर का उपयोग कर फोन नंबर की मात्रा के लिए एक अनुरोध भेजता है GET_SERVICES विधि लगभग हर 10-20 सेकंड।

यदि आप प्रतिक्रिया में एक गिनती > 0 प्रदान करते हैं, तो आपको फोन नंबर जारी करने के लिए एक अनुरोध प्राप्त होगा GET_NUMBER विधि।

प्राप्त करने के बाद GET_NUMBER अनुरोध, आपको एक प्रदान करना आवश्यक है
फोन नंबर जो सभी मानदंडों को पूरा करता है और आने वाले सभी एसएमएस संदेशों का उपयोग करके हमें अग्रेषित करता है PUSH_SMS विधि। यह हमारे लिए आवश्यक है कि हम स्पष्ट और वस्तुनिष्ठ फ़िल्टरिंग करें और प्रासंगिक एसएमएस संदेशों को अपने ग्राहकों के लिए सही सेवा प्रदान करें ।

फोन नंबर से संबंधित सभी आवश्यक कार्यों को पूरा करने पर, आपको 3 के माध्यम से एक स्थिति प्राप्त होगी FINISH_ACTIVATION विधि। यह स्थिति इंगित करती है कि फ़ोन नंबर सफलतापूर्वक पंजीकृत किया गया था, और आपको इसके लिए पुरस्कृत किया गया है ।

आवश्यकताएँ:

अनुरोध / प्रतिक्रिया प्रारूप: जेएसओएन
यूटीएफ -8 एन्कोडिंग
ग्रिजली एसएमएस सर्वर के अनुरोधों में हमेशा उपयोगकर्ता-एजेंट हेडर का उपयोग करें

फ़ील्ड प्रकार:

पूर्णांक: -2 147 483 648 से 2 147 483 647 तक की सीमा में पूर्णांक मान
यूिंट : 0 से 2 147 483 647 तक की सीमा में अहस्ताक्षरित पूर्णांक मान
लंबा: -9 223 372 036 854 775 808 से 9 223 372 036 854 775 807 तक की सीमा में पूर्णांक मान
उलोंग: 0 से 9 तक की सीमा में अहस्ताक्षरित लंबा पूर्णांक मान 223 372 036 854 775 807
वक्र: वास्तविक मान जिसमें 2 दशमलव स्थान हैं, उदाहरण के लिए, 177.77
बूलियन: शाब्दिक मूल्य सही या गलत
स्ट्रिंग: असीमित लंबाई का स्ट्रिंग मान
स्ट्रिंग की सरणी: स्ट्रिंग बड़े पैमाने पर

1. GET_SERVICES number request method

यह अनुरोध हमें बिक्री के लिए उपलब्ध सेवाओं के लिए फोन नंबर की मात्रा के बारे में जानकारी प्रदान करता है ।

पोस्ट अनुरोध ग्रिजली एसएमएस सर्वर से पार्टनर के सर्वर पर प्रेषित किया जाता है ।

! कृपया ध्यान दें: यदि आपका जीएसएम मॉडेम समवर्ती सक्रिय मॉड्यूल की संख्या में सीमित है, तो आपको सक्रिय मॉड्यूल की संख्या के बराबर गिनती प्रदान करनी चाहिए ।

अनुरोध फ़ील्ड
फील्ड	प्रकार	आवश्यक है	विवरण
कार्रवाई	स्ट्रिंग		GET_SERVICES
कुंजी	स्ट्रिंग		प्रोटोकॉल कुंजी

Answer fields:
फील्ड	प्रकार	आवश्यक है	अवतरण
स्थिति	स्ट्रिंग		प्रतिक्रिया की स्थिति (см. Status Table)
देश-सूची	देशसूची की सरणी		देशों की सूची

CountryList
फील्ड	प्रकार	आवश्यक है	विवरण
देश	स्ट्रिंग		(देखें डेटा तालिका )
ऑपरेटरमैप*	साहचर्य ऐरे		कुंजी-ऑपरेटर (देखें डेटा तालिका), सेवाओं का मूल्य-सहयोगी सरणी**

* आपको ओपेरा मैप में खाली डेटा सरणियाँ नहीं भेजनी चाहिए

** सेवाओं की सहयोगी सरणी: कुंजी-एक संक्षिप्त सेवा नाम (डेटा तालिका देखें), मूल्य - सेवा के लिए उपलब्ध फोन नंबरों की मात्रा (प्रकार: इंट)

एक अनुरोध का उदाहरण:

{
  "action": "GET_SERVICES",
  "key": "qwerty123"
}

एक उत्तर का उदाहरण:

{
  "countryList":
    [
      {
        "country": "russia",
        "operatorMap":
          {
            "any":
              {
                "vk": 3,
                "ok": 10
              }
          }
      },
      {
        "country": "ukraine",
        "operatorMap":
          {
            "any":
              {
                "vk": 0,
                "wa": 32
              }
          }
      }
    ],
  "status": "SUCCESS"
}

2. GET_NUMBER request method

यह अनुरोध हमें एक फ़ोन नंबर प्रदान करता है जिसे हम क्लाइंट को देते हैं ।

यदि अपवाद फ़ोनसेट सरणी में उपसर्गों की एक सूची है, उदाहरण के लिए 44742 और 44740, आपको एक संख्या प्रदान नहीं करनी चाहिए जो इनमें से किसी भी उपसर्ग से शुरू होती है । अंकों की संख्या उपसर्ग के आकार तक सीमित नहीं है ।

**अनुरोध फ़ील्ड:**
फील्ड	प्रकार	आवश्यक है	अवतरण
कार्रवाई	स्ट्रिंग		GET_NUMBER
कुंजी	स्ट्रिंग		प्रोटोकॉल कुंजी
देश	स्ट्रिंग		देखें डेटा तालिका
सेवा	स्ट्रिंग		देखें डेटा तालिका
ऑपरेटर	स्ट्रिंग		देखें डेटा तालिका
योग	कूर		सफलतापूर्वक पंजीकृत सेवा के लिए आपको प्राप्त होने वाली राशि
अपवाद फोनसेट	स्ट्रिंग की सरणी		फोन नंबर का अनुरोध करते समय देने के लिए निषिद्ध उपसर्गों की सूची

**Answer fields**
Field	Type	Required	Description
status	String		(see Status Table)
number	Ulong		Phone number with country code
activationId	Ulong		Activation ID in the partner's system

Example of a request:

{
  "action": "GET_NUMBER",
  "key": "qwerty123",
  "country": "russia",
  "operator": "any",
  "service": "tg",
  "sum": 20.00,
}

अपवाद फोनसेट के साथ अनुरोध का उदाहरण

{
  "action": "GET_NUMBER",
  "key": "qwerty123",
  "country": "russia",
  "operator": "any",
  "service": "vk",
  "sum": 10,
  "exceptionPhoneSet": [
    "7918",
    "79281"
  ]
}

एक उत्तर का उदाहरण:

{
  "status": "SUCCESS",
  "number": 79157891133,
  "activationId": 571346
}

संख्या न होने की स्थिति में उत्तर का उदाहरण:

{
  "status": "NO_NUMBERS"
}

3. Delivery of SMS to the Grizzly SMS server using the PUSH_SMS method

यह पोस्ट अनुरोध भागीदार के सर्वर से पते पर ग्रिजली एसएमएस सर्वर पर भेजा जाता है: https://api.grizzlysms.com/agent/api/sms

यदि आपको "सफलता" स्थिति के साथ प्रतिक्रिया मिलती है, तो एसएमएस को अपने डेटाबेस में सफलतापूर्वक वितरित करें और इसे फिर से न भेजें । यदि "सफलता" के अलावा कोई स्थिति वापस आ जाती है, तो "सफलता" स्थिति प्राप्त होने तक 10 सेकंड की देरी के साथ अनुरोध दोहराएं ।

अनुरोध फ़ील्ड
फील्ड	प्रकार	आवश्यक है	विवरण
कार्रवाई	स्ट्रिंग		PUSH_SMS
कुंजी	स्ट्रिंग		प्रोटोकॉल कुंजी
एसएमएसआईडी	उलोंग		साथी के सिस्टम में एसएमएस की आईडी
फोन	उलोंग		फोन नंबर (काउंटी कोड सहित) जिस पर एसएमएस भेजा गया था
फोनफ्रॉम	स्ट्रिंग		प्रेषक का नाम (या तो अल्फ़ान्यूमेरिक या संख्यात्मक हो सकता है) जिसने एसएमएस भेजा
पाठ	स्ट्रिंग		एसएमएस पाठ

प्रतिक्रिया क्षेत्रों की संरचना
फील्ड	प्रकार	आवश्यक है	विवरण
स्थिति	स्ट्रिंग		(देखें स्थिति तालिका)

एक अनुरोध का उदाहरण:

{
  "action": "PUSH_SMS",
  "key": "qwerty123",
  "smsID": 1
  "phone": 447472190082
  "phoneFrom": "Microsoft",
  "text": "Microsoft access code: 5015"
}

एक उत्तर का उदाहरण:

{
  "status": "SUCCESS"
}

4. Activation completion request method FINISH_ACTIVATION

यह अनुरोध सक्रियण को पूरा करने के लिए ग्रिजली एसएमएस सर्वर से पार्टनर के सर्वर पर प्रेषित किया जाता है ।

ग्रिजली एसएमएस सर्वर से पार्टनर के सर्वर पर शुरू किया गया पोस्ट अनुरोध ।

सक्रियण प्रबंधन पूरी तरह से ग्रिजली एसएमएस द्वारा नियंत्रित है । हमारे नियंत्रण से परे कारकों के कारण, हमें एक सफल स्थिति परिवर्तन के संबंध में आपसे कोई प्रतिक्रिया नहीं मिल सकती है । इसलिए, यदि ग्रिजली एसएमएस एक बार-बार सक्रियण पूर्णता अनुरोध भेजता है, तो आपको अपने अंत में सक्रियण आईडी के अस्तित्व की जांच करनी चाहिए । यदि सक्रियण मौजूद है, तो प्रतिक्रिया में सफलता की स्थिति भेजें ।

**अनुरोध फ़ील्ड**
फील्ड	प्रकार	आवश्यक है	अवतरण
कार्रवाई	स्ट्रिंग		FINISH_ACTIVATION
कुंजी	स्ट्रिंग		प्रोटोकॉल कुंजी
सक्रियण आईडी	उलोंग		दूसरे अनुरोध में प्राप्त सक्रियण आईडी
स्थिति	उलोंग		स्थिति तालिका देखें
उत्तर फ़ील्ड
फील्ड	प्रकार	आवश्यक है	अवतरण
स्थिति	स्ट्रिंग		स्थिति तालिका देखें

एक अनुरोध का उदाहरण:

{
  "action": "FINISH_ACTIVATION",
  "key": "qwerty123",
  "smsId": 100,
  "status": 3
}

एक उत्तर का उदाहरण:

{
  "status": "SUCCESS"
}

Testing the protocol

एक साथ संख्या जारी करना । आपको एक साथ अनुरोधों को ठीक से संभालना चाहिए और बार-बार नंबर जारी नहीं करना चाहिए । उदाहरण के लिए, यदि आपके पास टेलीग्राम इंडोनेशिया के लिए 100 नंबर हैं, और ग्रिजली एसएमएस एक साथ टेलीग्राम यूनाइटेड किंगडम के लिए 100 अनुरोध करता है, तो पार्टनर सर्वर को 100 अद्वितीय नंबर प्रदान करने चाहिए । यदि कोई संख्या कई बार जारी की जाती है, तो परीक्षण विफल हो जाता है ।

क्रेक्ट सक्रियण पूरा होना । सक्रियण स्थिति में परिवर्तन पूरी तरह से ग्रिजली एसएमएस द्वारा नियंत्रित होता है । भागीदार सर्वर को स्वायत्त रूप से पूर्ण सक्रियण नहीं करना चाहिए ।

एसएमएस वितरण सत्यापन। एक बार जब आप एक एसएमएस प्राप्त करते हैं, तो आपको इसे तुरंत ग्रिजली एसएमएस सर्वर पर अग्रेषित करना होगा । यदि आपको सफलता की स्थिति मिलती है, तो आपको एसएमएस को फिर से अग्रेषित नहीं करना चाहिए । हालाँकि, यदि आपको कोई भिन्न स्थिति प्राप्त होती है, तो आपको हर 10-20 सेकंड में अनुरोध को पुनः प्रयास करना चाहिए । यदि सफलता की स्थिति प्राप्त करने के बाद फिर से एक एसएमएस जारी किया जाता है, तो परीक्षण विफल हो जाता है ।

फ़ील्ड प्रकार सत्यापन। इस दस्तावेज़ में निर्दिष्ट फ़ील्ड प्रकारों की पूरी तरह से जाँच करें । यदि इस स्थिति का उल्लंघन होता है, तो परीक्षण विफल हो जाता है ।

फोन नंबर में देश कोड। फोन नंबर जारी करना डिजिटल प्रारूप में होना चाहिए और इसमें देश कोड शामिल होना चाहिए ।

संख्या जारी करने का समय सत्यापन। आपको 3 सेकंड से कम की देरी के साथ नंबर जारी करना होगा । यदि इसमें 3 सेकंड से अधिक समय लगता है, तो परीक्षण विफल हो जाता है ।

संख्या मात्रा सत्यापन। यदि आप संख्या की मात्रा के अनुरोध में 1000 नंबर जारी करते हैं, लेकिन एक ही समय में केवल 100 जारी किए जाते हैं, तो परीक्षण विफल हो गया है ।

अपवाद हैंडलिंग सत्यापन। यदि आप किसी संख्या को जारी करने के लिए अपवादों को गलत तरीके से संभालते हैं, तो परीक्षण विफल हो गया है ।

Status Table

**अनुरोध फ़ील्ड की संरचना**
स्थिति	विवरण
सफलता	अनुरोध सफलतापूर्वक समाप्त हो गया था
त्रुटि	अनुरोध निष्पादन के दौरान त्रुटि । त्रुटि फ़ील्ड को विवरण से भरा जाना चाहिए
NO_NUMBERS	कोई संख्या उपलब्ध नहीं है । यह प्रतिक्रिया केवल एक नंबर अनुरोध के लिए वापस की जाती है
सक्रियण स्थिति
स्थिति	अवतरण
1	इस सेवा के लिए एक नंबर जारी करना निषिद्ध है
3	सक्रियण सफलतापूर्वक बेचा गया था । आपको एक इनाम मिला है
4	सक्रियण रद्द कर दिया गया था*
5	सक्रियण वापस कर दिया गया है । ग्राहक को सक्रियण के लिए वापस कर दिया गया है । यह संभव है कि यह संख्या पहले पंजीकृत थी, और संख्या पर दो-कारक प्रमाणीकरण सक्षम हो सकता है

**रद्दीकरण का तंत्र निम्नानुसार काम करता है: यदि कोई फ़ोन नंबर 5 बार रद्द किया गया है, तो आपको उसी नंबर को फिर से जारी नहीं करना चाहिए । यह संभव है कि संख्या ग्राहक के लिए उपयुक्त नहीं थी या विशिष्ट सेवा के लिए पहले से पंजीकृत थी ।

अनुरोध का सफल उत्तर:

{
  "status": "SUCCESS",
  //information
}

त्रुटि के मामले में उत्तर दें:

{
  "status": "ERROR",
 "error": "Description of the error"
}

Data Table

**डेटा तालिका:**
सूचियाँ	लिंक
देशों की सूची	नाम और आईडी वाले देशों की पूरी सूची लिंक पर मिल सकती है https://grizzlysms.com/docs
ऑपरेटरों की सूची	फिलहाल, ऑपरेटरों द्वारा ब्रेकडाउन विकास के अधीन है, इसलिए आपको 'कोई भी'मान पास करना चाहिए । एक बार यह कार्यक्षमता लागू हो जाने के बाद, हम आपको तकनीकी सहायता चैट के माध्यम से सूचित करेंगे ।
सेवाओं की सूची	नाम और आईडी वाली सेवाओं की पूरी सूची लिंक पर मिल सकती है https://grizzlysms.com/docs

API for price change

यह एपीआई आपके पक्ष (सेवाओं की कीमतों) पर स्लाइडर्स के साथ काम के स्वचालितकरण के उद्देश्य से है ।

इस पते से एपीआई मिल सकता है https://apiagent.7grizzlysms.com.
अनुरोधों में प्रमाणीकरण के लिए आपको एचटीटीपी-हेडर में अपनी एपीआई-कुंजी भेजने की आवश्यकता है apikey.

सभी डेटा जेएसओएन प्रारूप में प्रेषित होते हैं ।
जीईटी अनुरोधों के लिए, एचटीटीपी-हेडर भेजना आवश्यक है Accept: application/json, पोस्ट अनुरोध के लिए के रूप में - Accept: application/json and Content-Type: application/json.

देश पैरामीटर के उपलब्ध मान में स्थित हैं देश सूची कॉलम आईडी और देशों में, इसलिए, आप 0 और दोनों का उपयोग कर सकते हैं russia |
Available values of the service parameter are located in सेवाओं की सूची कॉलम आईडी में ।

Terms and fines

निकासी पाया. अर्जित धन की निकासी अनुरोधों द्वारा की जाती है । एक साथी में एक अनुरोध बना सकते हैं निकासी अनुभाग। एक लेनदेन के लिए 100 यूएसडीटी से कमाई की निकासी उपलब्ध है । अनुरोधों को प्रतिदिन 8:00 से 20:00 (यूटीसी) तक 20 से 180 मिनट के भीतर संसाधित किया जाता है । यदि आपको कोई बोनस देने का वादा किया जाता है (वेबसाइट पर प्रकाशित नियमों और शर्तों के अनुसार), तो कृपया अनुरोध पर टिप्पणियों में इसे इंगित करना सुनिश्चित करें ।

2 एफए और गलत कोड के लिए मुआवजा । ग्रिजली एसएमएस प्लेटफॉर्म, एक मध्यस्थ के रूप में, 2 एफए और गलत कोड के साथ टेलीग्राम नंबर के लिए ग्राहकों को क्षतिपूर्ति करता है । ग्रिजली एसएमएस टेलीग्राम विशेषज्ञ और टीजी-विशाल सॉफ्टवेयर से स्वचालित रूप से 2 एफए पर जानकारी प्राप्त करता है । महत्वपूर्ण: 2 एफए और गलत कोड (उत्तर 'गलत कोड') के साथ संख्याओं के लिए धन और टेलीग्राम खातों पर शुल्क नहीं लिया जाता है । आप 2 एफए या गलत कोड के बारे में जानकारी देख सकते हैं सक्रियण इतिहास ।