==== Web Service SMS Free ====

Pour les abonnés Free Mobile,  un service de notification SMS pour vos appareils connectés est disponible.
Pour l'utiliser il faut d'abord configurer le service ainsi :  [[https://www.freenews.fr/freenews-edition-nationale-299/free-mobile-170/nouvelle-option-notifications-par-sms-chez-free-mobile-14817|explications sur la mise en oeuvre du service SMS de free]].
Ensuite il vous suffit d'appeler le lien suivant : https://smsapi.free-mobile.fr/sendmsg
avec les paramètres suivants :

  * user : votre login
  * pass : votre clé d’identification générée automatiquement par notre service
  * ms : le contenu du SMS encodé sous forme d’url (Percent-encoding)

Par exemple, pour envoyer le message « Hello World ! » sur votre mobile, il vous faudra appeler : 


https://smsapi.free-mobile.fr/sendmsg?user=XXXXXXXX&pass=XXXXXXXXXXXXXX&msg=Hello%20World%20!

Vous pouvez également, si vous le préférez, envoyer les paramètres en POST. Dans ce cas, le contenu du message n’a pas besoin d’être encodé.

Le code de retour HTTP indique le succès ou non de l’opération :

  * 200 : Le SMS a été envoyé sur votre mobile
  * 400 : Un des paramètres obligatoires est manquant
  * 402 : Trop de SMS ont été envoyés en trop peu de temps
  * 403 : Le service n’est pas activé sur l’espace abonné, ou login / clé incorrect.
  * 500 : Erreur côté serveur. Veuillez réessayez ultérieurement.

== Test sur une page Web du service SMS Free ==
Vous pouvez tester sur la page web  [[http://freeaddons.free.fr/smsfreetest/test%20de%20notification%20sms%20freemobile.php|suivante]] ,l'utilisation du service web SMS Free.

== Exemple d'appel en C# ==
{{:cours:bat4:intws:clientws_sms_free.zip|Exemple en C# d'appel à l'API d'envoi de SMS sur le service Web de Free}}