WINDEV Intégration API SMS pour la Tunisie | Guide WinSMS

// Construction du payload pour l'envoi d'un SMS en Tunisie avec WinSMS
vSms est un Variant
vMessage est un Variant
vMessage.sender = "Votre_Sender_ID" // Votre identifiant d'expéditeur
vMessage.text = "Votre message ici" // Le message à envoyer
vMessage.pushtype = "alert"
vSms.message = vMessage
tabNumbers est un tableau de chaînes = ["216xxxxxxxx"] // Numéro de téléphone destinataire en Tunisie (Avec indicatif 216)

tabGsm est un tableau de Variants
POUR TOUT sNumber DE tabNumbers
	vGsm est un Variant
	vGsm.value = sNumber
	tabGsm.Ajoute(vGsm)
FIN

vRecipient est un Variant
vRecipient.gsm = tabGsm
vSms.recipients = vRecipient

vPostData est un Variant
vPostData.sms = vSms

// Requête
sRequestUrl est une chaîne = "https://www.winsmspro.com/sms/sms/api"
sToken est une chaîne = "votre_clé_api" // Remplacez par votre clé API SMS Tunisie WinSMS réelle
sHeader est une chaîne
sHeader = "Accept: application/json" + RC + "Authorization: Bearer " + sToken

SI HTTPRequête(sRequestUrl, VariantVersJSON(vPostData), sHeader, "", "POST") = Vrai ALORS
	Trace("Requête OK, résultat : ", HTMLVersTexte(HTTPDonneRésultat())) // Imprime le résultat de l'API
SINON
	Erreur(ErreurInfo())
FIN

Ce code WinDev construit un payload pour l’envoi d’un SMS et le soumet via une requête HTTP POST. Notez que dans WinDev, HTTPRequête est utilisée pour effectuer la requête, avec les données et les entêtes nécessaires. Vous devrez adapter la partie d’authentification (sToken) selon la méthode spécifique d’authentification requise par WinSMS.

Gardez à l’esprit que WinDev utilise un environnement et une syntaxe qui lui sont propres, donc assurez-vous d’avoir les modules nécessaires pour les opérations HTTP et le traitement de JSON activés dans votre projet WinDev.

Astuce pour les développeurs : Vous pouvez également tester ces requêtes directement dans votre navigateur pour une vérification rapide du fonctionnement de notre API SMS. Il suffit de coller l’URL construite avec vos paramètres spécifiques dans la barre d’adresse et d’appuyer sur Entrée.

https://www.winsmspro.com/sms/sms/api?action=send-sms&api_key=VotreCléAPI&to=216xxxxxxxx&from=VotreIDExpéditeur&sms=VotreMessage

C’est une méthode pratique pour tester l’API WinSMS sans même avoir besoin de rédiger ou d’exécuter du code, ce qui peut être particulièrement utile pour les développeurs en train de se familiariser avec notre API ou pour ceux qui cherchent à effectuer des tests rapides d’envois d’SMS par API en Tunisie

// Construction du payload pour l'envoi d'un SMS groupé en Tunisie avec WinSMS
vSms est un Variant
vMessage est un Variant
vMessage.sender = "Votre_Sender_ID" // Remplacez par votre identifiant d'expéditeur
vMessage.text = "Votre message ici" // Le message à envoyer à tous les destinataires
vMessage.pushtype = "alert" // Type de notification pour le message
vSms.message = vMessage

// Liste des numéros de téléphone des destinataires en Tunisie
tabNumbers est un tableau de chaînes = ["216xxxxxxxx", "216yyyyyyyy", "216zzzzzzzz"]

tabGsm est un tableau de Variants
POUR TOUT sNumber DE tabNumbers
    vGsm est un Variant
    vGsm.value = sNumber
    tabGsm.Ajoute(vGsm)
FIN

vRecipient est un Variant
vRecipient.gsm = tabGsm
vSms.recipients = vRecipient

vPostData est un Variant
vPostData.sms = vSms

// Requête pour l'envoi du SMS groupé
sRequestUrl est une chaîne = "https://www.winsmspro.com/sms/sms/api"
sToken est une chaîne = "votre_clé_api" // Votre clé API SMS Tunisie WinSMS réelle
sHeader est une chaîne
sHeader = "Accept: application/json" + RC + "Authorization: Bearer " + sToken

// Envoi de la requête HTTP POST avec le payload JSON
SI HTTPRequête(sRequestUrl, "POST", sHeader, VariantVersJSON(vPostData), "application/json") = Vrai ALORS
    Trace("Requête réussie, résultat : ", HTMLVersTexte(HTTPDonneRésultat())) // Affiche le résultat de l'API
SINON
    Erreur("Erreur lors de l'envoi de la requête : ", ErreurInfo())
FIN

Ce pseudo-code WinDev montre comment préparer le payload pour un envoi groupé de SMS et comment effectuer la requête HTTP POST vers l’API WinSMS. Notez que la conversion exacte des types de données et la structure exacte de la requête peuvent nécessiter des ajustements selon les spécificités de l’API WinSMS et les capacités de votre version de WinDev.

Assurez-vous de remplacer "votre_clé_api", "Votre_Sender_ID", et les numéros de téléphone par les valeurs appropriées pour votre cas d’usage.

Astuce pour les développeurs : Vous pouvez également tester ces requêtes directement dans votre navigateur pour une vérification rapide du fonctionnement de notre API SMS. Il suffit de coller l’URL construite avec vos paramètres spécifiques dans la barre d’adresse et d’appuyer sur Entrée.

https://www.winsmspro.com/sms/sms/api?action=send-sms&api_key=VotreCléAPI&to=216xxxxxxxx,216yyyyyyyy,216zzzzzzzz&from=VotreIDExpéditeur&sms=VotreMessage

C’est une méthode pratique pour tester l’API WinSMS sans même avoir besoin de rédiger ou d’exécuter du code, ce qui peut être particulièrement utile pour les développeurs en train de se familiariser avec notre API ou pour ceux qui cherchent à effectuer des tests rapides d’envois d’SMS par API en Tunisie

// Initialisation des paramètres pour l'envoi d'un SMS via l'API WinSMS
vSms est un Variant
vMessage est un Variant
vMessage.sender = "Votre_Sender_ID" // Votre identifiant d'expéditeur réel
vMessage.text = "Votre message ici" // Le contenu de votre SMS
vSms.message = vMessage

// Numéro du destinataire du SMS
sNumber est une chaîne = "216xxxxxxxx" // Incluez l'indicatif pays 216 pour la Tunisie

tabGsm est un tableau de Variants
vGsm est un Variant
vGsm.value = sNumber
tabGsm.Ajoute(vGsm)

vRecipient est un Variant
vRecipient.gsm = tabGsm
vSms.recipients = vRecipient

vPostData est un Variant
vPostData.sms = vSms

// Construction de la requête HTTP
sRequestUrl est une chaîne = "https://www.winsmspro.com/sms/sms/api"
sToken est une chaîne = "votre_clé_api" // Utilisez votre clé API personnelle ici
sHeader est une chaîne
sHeader = "Accept: application/json" + RC + "Authorization: Bearer " + sToken

// Envoi de la requête et attente de la réponse
SI HTTPRequête(sRequestUrl, "POST", sHeader, VariantVersJSON(vPostData), "application/json") = Vrai ALORS
    Trace("Requête réussie, réponse : ", HTMLVersTexte(HTTPDonneRésultat()))
SINON
    Erreur("Erreur lors de l'envoi du SMS : ", ErreurInfo())
FIN

L’envoi de la requête se fait via HTTPRequête, une fonction hypothétique dans cet exemple représentant un appel HTTP typique en WinDev, avec des paramètres pour la méthode HTTP, les headers, et le corps de la requête. Le traitement de la réponse et l’affichage des résultats (ou des erreurs) permettent de vérifier l’efficacité de l’envoi.

Ce cadre suppose l’existence de fonctions WinDev adaptées pour le travail avec JSON et les requêtes HTTP, qui peuvent nécessiter l’utilisation de modules ou de bibliothèques externes disponibles dans l’écosystème WinDev.

N’oubliez pas de remplacer "votre_clé_api", "Votre_Sender_ID", et "216xxxxxxxx" par les informations réelles correspondant à votre compte WinSMS et au numéro de votre destinataire.

Astuce pour les développeurs : Vous pouvez également tester ces requêtes directement dans votre navigateur pour une vérification rapide du fonctionnement de notre API SMS. Il suffit de coller l’URL construite avec vos paramètres spécifiques dans la barre d’adresse et d’appuyer sur Entrée.

https://www.winsmspro.com/sms/sms/api?action=send-sms&api_key=VotreCléAPI&to=216xxxxxxxx&from=VotreIDExpéditeur&sms=VotreMessage

C’est une méthode pratique pour tester l’API WinSMS sans même avoir besoin de rédiger ou d’exécuter du code, ce qui peut être particulièrement utile pour les développeurs en train de se familiariser avec notre API ou pour ceux qui cherchent à effectuer des tests rapides d’envois d’SMS par API en Tunisie

// Configuration des paramètres pour l'envoi d'un SMS groupé en Tunisie avec WinSMS
vSms est un Variant
vMessage est un Variant
vMessage.sender = "Votre_Sender_ID" // Votre identifiant d'expéditeur réel
vMessage.text = "Votre message ici" // Le contenu de votre SMS à envoyer
vSms.message = vMessage

// Liste des numéros de téléphone des destinataires en Tunisie
tabNumbers est un tableau de chaînes = {"216xxxxxxxx", "216yyyyyyyy"} // Incluez l'indicatif pays 216 pour la Tunisie

tabGsm est un tableau de Variants
POUR TOUT sNumber DE tabNumbers
    vGsm est un Variant
    vGsm.value = sNumber
    tabGsm.Ajoute(vGsm)
FIN

vRecipient est un Variant
vRecipient.gsm = tabGsm
vSms.recipients = vRecipient

vPostData est un Variant
vPostData.sms = vSms

// Construction et envoi de la requête HTTP pour l'envoi groupé
sRequestUrl est une chaîne = "https://www.winsmspro.com/sms/sms/api"
sToken est une chaîne = "votre_clé_api" // Utilisez votre clé API personnelle ici
sHeader est une chaîne
sHeader = "Accept: application/json" + RC + "Authorization: Bearer " + sToken

SI HTTPRequête(sRequestUrl, "POST", sHeader, VariantVersJSON(vPostData), "application/json") = Vrai ALORS
    Trace("Requête réussie, réponse : ", HTMLVersTexte(HTTPDonneRésultat())) // Affiche la réponse de l'API
SINON
    Erreur("Erreur lors de l'envoi du SMS groupé : ", ErreurInfo())
FIN

Ce code illustre comment préparer les données d’un SMS groupé et les envoyer via une requête HTTP POST en utilisant l’API WinSMS Tunisie.

Notez que les fonctions telles que HTTPRequête et VariantVersJSON sont hypothétiques et servent à illustrer le processus général. Vous devrez adapter ces parties selon les capacités exactes de votre environnement WinDev et les librairies disponibles pour le traitement HTTP et JSON.

L’envoi de SMS via une API externe depuis WinDev nécessite une compréhension claire de l’API cible et de la manière d’intégrer ses appels dans le langage et l’environnement WinDev. Assurez-vous que votre clé API et les informations de destinataires sont correctement configurées avant d’exécuter votre code.

Astuce pour les développeurs : Vous pouvez également tester ces requêtes directement dans votre navigateur pour une vérification rapide du fonctionnement de notre API SMS. Il suffit de coller l’URL construite avec vos paramètres spécifiques dans la barre d’adresse et d’appuyer sur Entrée.

https://www.winsmspro.com/sms/sms/api?action=send-sms&api_key=VotreCléAPI&to=216xxxxxxxx,216yyyyyyyy,216zzzzzzzz&from=VotreIDExpéditeur&sms=VotreMessage

C’est une méthode pratique pour tester l’API WinSMS sans même avoir besoin de rédiger ou d’exécuter du code, ce qui peut être particulièrement utile pour les développeurs en train de se familiariser avec notre API ou pour ceux qui cherchent à effectuer des tests rapides d’envois d’SMS par API en Tunisie

// Configuration pour la consultation du solde via l'API WinSMS
sRequestUrl est une chaîne = "https://www.winsmspro.com/sms/sms/api?action=check-balance&api_key=" + "votre_clé_api" + "&response=json"
sToken est une chaîne = "votre_clé_api" // Remplacez par votre clé API SMS Tunisie WinSMS réelle
sHeader est une chaîne
sHeader = "Accept: application/json" + RC + "Authorization: Bearer " + sToken

// Envoi de la requête HTTP GET pour consulter le solde
SI HTTPRequête(sRequestUrl, "", sHeader, "", "GET") = Vrai ALORS
    Trace("Requête réussie, solde : ", HTMLVersTexte(HTTPDonneRésultat())) // Affiche la réponse de l'API, typiquement en JSON
SINON
    Erreur("Erreur lors de la consultation du solde : ", ErreurInfo())
FIN

Ce pseudo-code WinDev illustre la procédure pour envoyer une requête HTTP GET à l’API WinSMS afin de consulter le solde du compte associé à la clé API fournie. Il utilise une chaîne d’URL directement incorporée avec la clé API et le format de réponse désiré. Le traitement des réponses JSON peut nécessiter l’utilisation de fonctionnalités spécifiques à WinDev pour le parsing de JSON, dépendant de votre version et configuration de WinDev.

Le sHeader contient les informations d’en-tête nécessaires, notamment le type d’acceptation (Accept: application/json) et l’authentification via le token (Authorization: Bearer). Assurez-vous que le token (sToken) est bien configuré pour authentifier vos requêtes auprès de l’API WinSMS.

Comme toujours, avant d’exécuter ce code, vérifiez que toutes les informations sont correctement renseignées, notamment votre clé API SMS Tunisie WinSMS.

Astuce pour les développeurs : Vous pouvez également tester ces requêtes directement dans votre navigateur pour une vérification rapide du fonctionnement de notre API SMS. Il suffit de coller l’URL construite avec vos paramètres spécifiques dans la barre d’adresse et d’appuyer sur Entrée.

https://www.winsmspro.com/sms/sms/api?action=check-balance&api_key=votre_clé_api&response=json

C’est une méthode pratique pour tester l’API WinSMS sans même avoir besoin de rédiger ou d’exécuter du code, ce qui peut être particulièrement utile pour les développeurs en train de se familiariser avec notre API SMS ou pour ceux qui cherchent à effectuer des tests rapides d’envois d’SMS par API en Tunisie

// Configuration pour vérifier l'état d'un SMS envoyé via l'API WinSMS
sRequestUrl est une chaîne = "https://www.winsmspro.com/sms/sms/api/verifSms?api_key=" + "votre_clé_api" + "&ref=" + "123456789"
sToken est une chaîne = "votre_clé_api" // Remplacez par votre clé API SMS Tunisie WinSMS réelle
sHeader est une chaîne
sHeader = "Accept: application/json" + RC + "Authorization: Bearer " + sToken

// Envoi de la requête HTTP GET pour vérifier l'état d'un SMS spécifique
SI HTTPRequête(sRequestUrl, "", sHeader, "", "GET") = Vrai ALORS
    Trace("Requête réussie, état du SMS : ", HTMLVersTexte(HTTPDonneRésultat())) // Affiche la réponse de l'API, typiquement en JSON
SINON
    Erreur("Erreur lors de la vérification de l'état du SMS : ", ErreurInfo())
FIN

Dans ce snippet WinDev, nous envoyons une requête HTTP GET pour interroger l’API WinSMS et vérifier l’état d’un SMS spécifique, en utilisant sa référence (ref). La requête incorpore votre clé API pour l’authentification et spécifie que vous attendez une réponse en format JSON (Accept: application/json). Le token d’authentification est envoyé via les en-têtes HTTP.

Le sRequestUrl est construit avec l’URL de base de l’API, votre clé API, et la référence du SMS dont vous souhaitez vérifier l’état. Veillez à remplacer "votre_clé_api" et "123456789" par votre clé API réelle et la référence réelle du SMS concerné.

Cette méthode simplifiée illustre comment interagir avec des APIs web en WinDev pour des tâches spécifiques comme l’envoi et la vérification d’SMS, en gardant un œil sur la facilité d’implémentation et l’efficacité du code.

Astuce pour les développeurs : Vous pouvez également tester ces requêtes directement dans votre navigateur pour une vérification rapide du fonctionnement de notre API SMS. Il suffit de coller l’URL construite avec vos paramètres spécifiques dans la barre d’adresse et d’appuyer sur Entrée.

https://www.winsmspro.com/sms/sms/api/verifSms?api_key=VOTRE-API-KEY&ref=123456789

C’est une méthode pratique pour tester l’API WinSMS Tunisie sans même avoir besoin de rédiger ou d’exécuter du code, ce qui peut être particulièrement utile pour les développeurs en train de se familiariser avec notre API ou pour ceux qui cherchent à effectuer des tests rapides d’envois d’SMS par API en Tunisie