Ce document fournit une référence pour toutes les fonctions auxquelles vous pouvez accéder via l'interface HTTP pour l'envoi d'SMS
L'API HTTP vous permet d'intégrer votre application (client) à la (Passerelle) de easysms en utilisant le protocole HTTP pour envoyer un SMS. Le HTTPS est spécifiquement pris en charge pour toutes les transactions utilisant le cryptage SSL.
Informations générales
Le client envoie une requête HTTP GET à l'interface HTTP de easysms , cette requête contient une liste de paramètres requis. easysms renvoie une réponse HTTP indiquant le succès de l'opération
A Noter que le délimiteur utilisé dans de nombreux cas cités ci-dessous dans les données renvoyées, '|', est le caractère pipe (ASCII 124). Veuillez ne pas oublier d'encoder tous les paramètres transférés au format URL.
Voici ci-dessous les commandes disponibles dans cette version de l'API de easysms.
Envoi d'SMS
URL: https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms
Paramètres acceptés
| Paramètre | Description | Présence |
|---|---|---|
text |
Message à envoyer. Doit être encodé au format URL. | Obligatoire |
mobile_number |
Le numéro MSISDN du destinataire indiquant que le message est à envoyer à. Ex: 49175123456 | Obligatoire |
originator |
ID d'expéditeur (s'il est au format alphanumérique, 11 caractères maximum. S'il est au format numérique, 16 chiffres maximum | Facultatif |
flash |
Définir en tant que 'Vrai' pour envoyer un SMS Flash | Facultatif |
request_delivery |
Définir en tant que 'Vrai' pour obtenir un accusé de réception pour le SMS envoyé | Facultatif |
Renvoie
return_code | sms_id | balance
| Description | |
|---|---|
return_code |
1 pour le message envoyé, sinon : échec d'envoi du message |
sms_id |
l'ID du message, les accusés de réception sont livrés selon les ID des messages |
balance |
le solde du compte |
Exemple de requête pour envoyer des SMS
Pour envoyer un SMS contenant l'expression 'Hello World' à '49175123456' présenté comme étant envoyé par 'MyCompany' vous devez utiliser:
https://www.net2sms.gr/srvauth/index?cmd=easysms&action=send_sms&text=Hello%20World&mobile_number=49175123456&originator=MyCompany
La passerelle répondra par quelque chose comme:
1|456123789|112
qui se traduit par le SMS a été mis en attente avec succès avec l'id 456123789 et votre solde est 112