The partner protocol is designed to provide phone numbers and incoming SMS messages via API directly to the Grizzly SMS server.
All requests include the parameter — KEY. This key is provided by support staff and is available in the personal account.
Quantity requests GET_SERVICES, number requests GET_NUMBER and activation completion requests FINISH_ACTIVATION are sent directly from our server to the partner's server.
URL format : https://GrizzlySMS where GrizzlySMS can be partner.ru:port/GrizzlySMS.php or partner.ru/GrizzlySMS.php
- GET_SERVICES
- GET_NUMBER
- PUSH_SMS
- FINISH_ACTIVATION
- The Grizzly SMS server sends a request for quantity of phone numbers using the GET_SERVICES method approximately every 10-20 seconds.
- If you provide a count > 0 in response, you will receive a request for phone number issuance using the GET_NUMBER method.
- After receiving the GET_NUMBER request, you are required to provide a phone number that meets all criteria and forward all incoming SMS messages to us using the PUSH_SMS method. This is necessary for us to perform clear and objective filtering and deliver the relevant SMS messages to the right service for our clients.
- Upon completing all necessary tasks related to the phone numbers, you will receive a status 3 through the FINISH_ACTIVATION method. This status indicates that the phone number was successfully registered, and you have been rewarded for it.
Requirements:
- Request/response format: JSON
- UTF-8 encoding
- Always use a user-agent header in requests to the Grizzly SMS server
Field types:
- int : integer value in the range from -2 147 483 648 to 2 147 483 647
- Uint : unsigned integer value in the range from 0 to 2 147 483 647
- long : integer value in the range from -9 223 372 036 854 775 808 to 9 223 372 036 854 775 807
- Ulong : unsigned long integer value in the range from 0 to 9 223 372 036 854 775 807
- cur : real value containing up to 2 decimal places, for example, 177.77
- boolean : literal values true or false
- string : string value of unlimited length
- array of string: string massive