L'interface envoiHTTP vous permet d'automatiser l'envoi
de SMSs vers un ou plusieurs destinataires. Ces messages peuvent être
envoyés immédiatement ou vous pouvez programmer leur date d'émission.
Attention bien que le mode HTTP soit supporté, il est fortement
conseillé pour des raisons de sécurité d'utiliser le mode HTTPS.
Les méthodes HTTP GET et POST sont supportées, mais seule la méthode POST
permet l'envoi de SMS à plus de 300 destinataires (en une seule requête).
Exemple 1:
http://www.smsMode.com/fr/1.5/sendSMS.do?pseudo=jean&pass=abcd1234
&message=Bonjour+Maman&numero=3363123456,0623123457
Exemple 2:
http://www.smsMode.com/fr/1.5/sendSMS.do?pseudo=jean&pass=abcd1234
&message=Bon+anniversaire&numero=3363123456&date_envoi=21122008-14:35
URL de base
L'URL de base pour la requête http est la
suivante:
http://www.smsMode.com/fr/1.5/sendSMS.do
Paramètres
obligatoires
Paramètre
Description
pseudo
identifiant
de l'utilisateur
pass
Mot de passe
message
Message du
SMS à envoyer. Nombre maximal de caractères=160 max.
numero
liste de
numéros séparés par une virgule. Ces numéros sont sous le format
international e.g. (33612345678) ou sous la forme normale d'un
portable français (06xxxxxxxx). L'envoi par méthode HTTP GET limite le
nombre de destinataires à 300, la méthode POST n'a pas cette limitation.
Paramètres optionnels
Paramêtre option.
Description
date_envoi
date d'envoi
du message - format : ddmmyyyy-hh:mm:ss.
compteRendu
la valeur
"true" permet d'obtenir le ou les comptes-rendus de réceptions
liés à l'envoi d'un SMS. Cette option augmente le prix d'un SMS de
0,1 crédits par destinataire.
emetteur
Emetteur du SMS envoyé si le compte
contient plusieurs émetteurs possible.
classe_msg
2 SMS Standard (defaut)
3 SMS Pro (+0,3 crédit)
4 SMS répondable (+0,4 crédit)
5 SMS eco
refClient
Référence
client permettant de spécifier un identifiant propre à
l'application appellante (référence de sous compte par exemple).
Réponses:
La réponse à une requête d'envoi Http est de
la forme:
code_retour|description_status|smsID
(présent si code retour 0)
Code retour
Description
0
Accepté - le message a été accepté par le système et est en cours de traitement.
31
Erreur interne
32
Erreur d'authentification
33
Crédits insuffisants
35
Un paramêtre obligatoire est manquant (numéro ou message)
50
Temporairement inaccessible
Caractères
et encodage:
Seul un certain nombre de caractères sont
gérés pour l'envoi de SMS (spécifications GSM 03.38), si vous
spécifiez un caractère qui n'est pas présent dans la liste, celui ci
sera remplacé par ?. L'encodage utilisé est celui de la norme ISO-8859-1.
Voici la liste des caractères acceptés et leurs correspondances: