Le protocole partenaire est conçu pour fournir des numéros de téléphone et des SMS entrants via l’API directement au serveur Grizzly SMS.
Toutes les requêtes incluent le paramètre KEY. Cette clé est fournie par l’équipe de support et est disponible dans le compte personnel.
Les requêtes de quantité GET_SERVICES, les requêtes de numéro GET_NUMBER et les requêtes de fin d’activation FINISH_ACTIVATION sont envoyées directement depuis notre serveur vers le serveur du partenaire.
Format d’URL : https://GrizzlySMS, où GrizzlySMS peut être partner.ru:port/GrizzlySMS.php ou partner.ru/GrizzlySMS.php.
- GET_SERVICES
- GET_NUMBER
- PUSH_SMS
- FINISH_ACTIVATION
- Le serveur Grizzly SMS envoie une requête pour le nombre de numéros disponibles en utilisant la méthode GET_SERVICES environ toutes les 10 à 20 secondes.
- Si vous retournez une quantité > 0 dans la réponse, vous recevrez une requête d’attribution de numéro de téléphone via la méthode GET_NUMBER.
- Après réception de la requête GET_NUMBER, vous devez fournir un numéro de téléphone répondant à tous les critères et transférer tous les SMS entrants via la méthode PUSH_SMS. Ceci est nécessaire pour que nous puissions appliquer un filtrage clair et objectif et acheminer les SMS pertinents vers le service approprié pour nos clients.
- Une fois toutes les opérations nécessaires liées au numéro de téléphone terminées, vous recevrez le statut 3 via la méthode FINISH_ACTIVATION. Ce statut indique que le numéro a été utilisé avec succès pour l’inscription et que vous avez été rémunéré en conséquence.
Exigences :
- Format des requêtes/réponses : JSON
- Encodage : UTF-8
- Il faut toujours utiliser un en-tête user-agent dans les requêtes envoyées au serveur Grizzly SMS
Types de champs :
- int : valeur entière comprise entre -2 147 483 648 et 2 147 483 647
- Uint : valeur entière non signée comprise entre 0 et 2 147 483 647
- long : valeur entière comprise entre -9 223 372 036 854 775 808 et 9 223 372 036 854 775 807
- Ulong : valeur entière longue non signée comprise entre 0 et 9 223 372 036 854 775 807
- cur : nombre réel avec jusqu’à 2 décimales, par exemple 177.77
- boolean : valeurs booléennes true ou false
- string : chaîne de caractères de longueur illimitée
- array of string : tableau de chaînes de caractères