Pour envoyer un SMS à travers la plate-forme, le client nous envoie une requête sur le site indiqué plus loin, en utilisant certains paramètres (texte à envoyer, numéro de téléphone, destinataire, expéditeur, etc.), et nous lui renvoyons une réponse confirmant que tout s’est bien passé, sinon un message d’erreur.
Les options de configuration disponibles, l’URL qu’il faut utiliser, et les paramètres pris en charge sont détaillés ci-après.
Pour générer l’URL, le client doit effectuer un appel GET à l’adresse suivante :
https://gateway.nrsgateway.com/send.php
Paramètres de l’appel :
text
Texte du message. Il comprendra au plus 160 parties, si vous ne précisez pas qu’il aura plusieurs parties (voir le paramètre 'parts'). Le texte doit être encodé en UTF-8
to
Numéro de téléphone portable du destinataire du message. Il doit inclure le préfixe (par exemple : en Espagne, 34666666666). Ce champ permet de spécifier plusieurs destinataires, il faut séparer les numéros de téléphone par une espace (par exemple : 34666666666 34666666667 34666666668)
from
Texte de l’expéditeur (en option), cette balise sera composée de 15 chiffres ou de 11 caractères alphanumériques.
username
Code client (numéro de téléphone portable enregistré sur NRS Gateway)
password
Clé d’accès du client sur nrsgateway.com
coding
Les valeurs possibles sont 0 et 8. La valeur 0 correspond aux envois normaux au format GSM7 avec 160 caractères par message et la valeur 8 correspond au format UCS2 (UTF16) avec 70 caractères par message.
dlr-mask(en option)
Pour recevoir les confirmations de réception, il faut garder la valeur 8. Il est inutile de spécifier ce paramètre quand elles ne sont pas requises.
fSend (en option)
Date d’envoi du message. Si vous avez besoin d’envoyer des messages programmés, vous pouvez spécifier la date d’envoi en indiquant le format de date AAAAmmddHHiiss (Par exemple 20130215142000 représente le 15 février 2013 à 14 h 20). En cas d’envoi immédiat, il est inutile de spécifier ce paramètre.
parts(en option)
Indique le nombre maximum de parties selon lesquelles le message à envoyer est divisé. Cette variable vaut 1 par défaut, un message de plus de 160 caractères pour le codage 0 envoyé sans qu’elle soit spécifiée ne passera pas. Gardez à l’esprit que les messages concaténés ne peuvent avoir que 153 caractères par partie et chaque partie est facturée comme un envoi. Le serveur utilisera uniquement le nombre minimal de parties nécessaire à l’envoi du texte, même si le nombre de parties spécifié est plus élevé que nécessaire. Si le nombre de parties est inférieur à celui requis pour l’envoi du texte, celui-ci échoue avec l’erreur 105.
trsec (en option)
Les valeurs possibles sont 1 et 0. Avec la valeur 0, qui est la valeur par défaut, le serveur ne modifie pas de caractère dans le message. Avec la valeur 1, le serveur se charge de modifier les caractères communs invalides au format GSM7 en caractères valides en se servant de la table de traduction suivante : 'á' => 'a', 'í'=>'i', 'ó'=>'o', 'ú'=>'u', 'ç'=>'Ç', 'Á'=>'A', 'Í'=>'I', 'Ó'=>'O', 'Ú'=>'U', 'À'=>'A', 'È'=>'E', 'Ì'=>'I', 'Ò'=>'O', 'Ù'=>'U', 'º' => '', 'ª' => '', 'Õ' => 'O', 'õ' => 'o', 'â' => 'a', 'ê' => 'e', 'î'=>'i', 'ô'=>'o', 'û'=>'u', 'Â'=>'A', 'Ê'=>'E', 'Î'=>'I', 'Ô'=>'O', 'Û'=>'U', 'ã' => 'a', 'Ã' => 'A'
Exemple d’appel :
Le mot de passe (password) et le code client (username) seront fournis par la société. Il faut signaler qu’afin d’accroître la sécurité du système, le client doit indiquer l’adresse IP d’où il se connectera. Uniquement les envois provenant de l’adresse IP spécifiée par le client seront autorisés.
Comme on le constate, la réponse renvoyée par la plate-forme à la suite d’une demande d’envoi de SMS aura la syntaxe suivante :
https://gateway.plusmms.net/send.php?username=tu_user &password=tu_login&to=3465467445+34627455334+34627545454&text=Prueba+de+envio&from=TEST&coding=0&dlr-mask=8
En cas d’erreur, une description de la raison de l’erreur est renvoyée.