La première étape est de vous identifier sur https://www.smsenvoi.com . Si vous ne possédez pas encore de compte, inscrivez-vous. Ensuite, rendez-vous sur la page d’informations de votre compte afin d’obtenir votre API KEY. Celle-ci est nécessaire à tout envoi de SMS depuis une API extérieure.
Envoyer des SMS depuis windows
Créez un nouveau projet Windev. Intégrez dans le code de votre fenêtre principale
//Définition des variables
emailsmsenvoi est une chaîne
apikeysmsenvoi est une chaîne
gammesms est une chaîne
expediteursms est une chaîne
messagesms est une chaîne
destinatairesms est une chaîne
RequêteEnvoi est un booléen
resultat est une chaîne
//Configuration de votre compte
emailsmsenvoi=”username” // username (nom d’utilisateur) de votre compte SMS Envoi
apikeysmsenvoi=”xxxxxxx” // Clef API KEY de votre compte SMS Envoi
//Configuration de l’envoi
gammesms=”PREMIUM” // Gamme du SMS ( LOWCOST / STANDARD / PREMIUM / LONG / MONDE / STOP)
expediteursms=”MonTest” //Nom de l’expéditeur à faire apparaître en PREMIUM
messagesms=”Bonjour, ca va ?” // Texte de votre SMS
destinatairesms = “+336xxxxxxx” // Numéro de destinataire, votre numéro de téléphone pour ce test
//Envoi
RequêteEnvoi= HTTPRequête(“http://app.www.smsenvoi.com/httpapi/sendsms”, “”, “”, URLEncode(“email=”+emailsmsenvoi+”&apikey=”+ apikeysmsenvoi +”&message[type]=sms&message[subtype]=”+ gammesms +”&message[senderlabel]=”+expediteursms+”&message[recipients]=”+destinatairesms+
“&message[content]=”+messagesms))
//Test du résultat de l’envoi
SI RequêteEnvoi=Vrai ALORS
resultat=HTTPDonneRésultat()
SINON
resultat=”Erreur”
FIN
SI Position(resultat,”””success””:1″)
Info(“Envoi effectué”)
SINON
Info(“Echec de l’envoi”)
FIN
Lancez le test de votre application et vous recevrez un SMS sur votre téléphone portable !
Comme vous pouvez le constater, l’envoi de SMS en lui même ne demande qu’une seule ligne de code, c’est la fonction HTTPRequête qui remplit cette tâche en générant une requête POST et en transmettant à notre serveur les paramètres adaptés. Afin d’effectuer la requête en HTTPS, remplacez simplement “http” par “https”.
Cet exemple effectue un envoi de SMS vers un seul destinataire, mais vous êtes libre d’en indiquer autant que vous le souhaitez en indiquant leur numéro séparé par une virgule dans la variable destinatairesms.
Envie d’aller plus loin dans l’apprentissage ?
Vous pourrez améliorer ces projets, notamment en ajoutant des fonctionnalités et en allant plus loin dans la gestion des messages d’erreur, en vous conformant à notre documentation API HTTP POST.
Notez que les messages de réponse de notre API HTTP POST sont fournis au format JSON. Les anciennes versions de windev ne traitent pas JSON nativement, nous n’avons donc volontairement pas implémenté de fonction de traitement JSON dans notre code source d’exemple afin de rendre ce code compatible avec la totalité des versions windev. Si votre version ne gère pas le JSON nativement, sachez que vous pouvez toutefois utiliser une classe telle que celle proposée sur le site.
Comme toujours avec Windev, votre projet sera compatible multi-plateforme. Vous pouvez biensûr également faire fonctionner notre API de la même façon avec Windev, Windev Mobile et Webdev afin de développer une application universelle d’envoi de SMS
Avertissement et limite de responsabilités :
Windev est un AGL permettant de développer rapidement des applications Windows, Linux, Java, .Net . Cet AGL édité par la société PC Soft reste la propriété de ses ayant droits. Cette page d’aide a été réalisée par SMS Envoi afin d’aider les clients et développeurs utilisant SMS Envoi et développant des applications sous Windev à développer des solutions intégrant notre solution. Ni PC Soft, ni SMS Envoi ne pourraient être tenus responsables de l’utilisation qui pourrait être faite du code ainsi que des exemples fournis. Ces exemples ont pour seul but de vous fournir une proposition de piste de développement. Les codes fournis n’ont pas vocation à être utilisés tels quels. Il vous appartient de mettre en place des mécanismes de sécurité fiables permettant d’éviter tout piratage de votre compte. Et ce notamment en ce qui concerne le stockage de vos informations confidentielles : email et API KEY. Nous vous encourageons à effectuer la totalité des requêtes en HTTPS. Dans le cas contraire, nous ne saurions être tenus responsables d’éventuelles divulgations de vos informations.
Commencez
votre essai gratuit
