|
Cet API Web est destiné aux développeurs afin de permettre d'intégrer simplement YlangSMS dans leurs logiciels ou sites Web.
Nous offrons l'intégration Web de YlangSMS sur votre site Web en PHP pour tout achat de crédit SMS d'un montant de 150€ minimum.
Exemple d'applications : demande d'envoi de code par SMS pour une inscription, confirmation de commande ou de rendez-vous, alertes en tout genre : intrusion, site indisponible, commande à traiter.
Le principe : vous effectuez une requête HTTP en GET
http://ylangsms.fr/send-sms.php?compte=0692XXXXXX&code=YYYYYY&destinataire=0692ZZZZZZ&message=test%20sms
Note 1 : compte=0692XXXXXX&code=YYYYYY sont les mêmes que ceux que vous utilisez pour le logicielNote 2 : dans l'exemple, le SMS est envoyé vers 0692ZZZZZZ (destinataire=). Le compte utilisé est 0692XXXXXX (compte=)Note 3 : vous pouvez tester ce code en faisant un copier-coller dans la barre d'adresse de votre navigateurNote 4 : vous pouvez utiliser le protocole https au lieu de http pour plus de sécurité (dans ce cas, utiliser https://ylangsms.fr au lieu de http://ylangsms.fr)
et en réponse, si l'envoi s'est bien passé, vous recevrez :
MESSAGEIDsmsYLANGSMS 0692ZZZZZZ MESSAGEIDsmsYLANGSMS SUCCESenvoiYLANGSMS 58.8 SUCCESenvoiYLANGSMS MESSAGELOGokYLANGSMS 0692ZZZZZZ MESSAGELOGokYLANGSMS
En cas d'échec, vous recevrez :
ECHECYLANGSMS 1004 ECHECYLANGSMS MESSAGELOGfailYLANGSMS MESSAGELOGfailYLANGSMS
Où ici 1004 est un code erreur. Voici la liste de codes erreur :
24 = Echec de vérification des données
1000 = Numéro invalide
1001 = Erreur d'envoi
1002 = Trop d'essai creation de compte
1003 = Erreur de base de donnees interne : re-essayez plus tard
1004 = Code incorrect
1005 = Crédit insuffisant
Donc vous pouvez analyser le texte de retour et si celui-ci contient SUCCESenvoiYLANGSMS cela signifie que le SMS est bien parti. Le nombre juste après est le crédit restant après l'envoi du SMS, ici 58.80 €.
Personnalisez votre expéditeur
Il suffit d'ajouter "&expediteur=0692AAAAAA" dans l'url, où 0692AAAAAA est le numéro de téléphone mobile de votre choix, que vous pouvez modifier à chaque requête. Ce numéro peut aussi être un fixe "&expediteur=0262AAAAAA", ou encore un texte court : "&expediteur=MONENTREPRISE". A noter que dans les deux derniers cas, vous ne pourrez pas avoir de réponse par SMS.
http://ylangsms.fr/send-sms.php?compte=0692XXXXXX&code=YYYYYY&destinataire=0692ZZZZZZ
&expediteur=0692AAAAAA&message=test%20sms
Attention, pas de caractère accentué, ni de ponctuation dans l'expéditeur. Limité à 13 caractères.
Aussi valable le numéro au format international avec un + au début (ex. +262692AAAAAA)
Pour envoyer le même message à plusieurs personnes
Il suffit de placer une virgule entre chaque numéro : "&destinataire=0692EEEEEE,0692FFFFFF,0692GGGGGG"
http://ylangsms.fr/send-sms.php?compte=0692XXXXXX&code=YYYYYY
&destinataire=0692EEEEEE,0692FFFFFF,0692GGGGGG&message=test%20sms
Le code de retour sera lors de ce type :
[MULTIPLE-1] MESSAGEIDsmsYLANGSMS 0692EEEEEE MESSAGEIDsmsYLANGSMS SUCCESenvoiYLANGSMS 57.6 SUCCESenvoiYLANGSMS MESSAGELOGokYLANGSMS 0692EEEEEE MESSAGELOGokYLANGSMS [MULTIPLE-2] MESSAGEIDsmsYLANGSMS 0692FFFFFF MESSAGEIDsmsYLANGSMS SUCCESenvoiYLANGSMS 57.45 SUCCESenvoiYLANGSMS MESSAGELOGokYLANGSMS 0692FFFFFF MESSAGELOGokYLANGSMS [MULTIPLE-3] MESSAGEIDsmsYLANGSMS 0693GGGGGG MESSAGEIDsmsYLANGSMS SUCCESenvoiYLANGSMS 57.3 SUCCESenvoiYLANGSMS MESSAGELOGokYLANGSMS 0693GGGGGG MESSAGELOGokYLANGSMS
Exemple simple d'envoi de SMS en PHP
<?
//---- Modifier ici le contenu des variables ----
$compte="0692XXXXXX";
$code="YYYYYY";
$destinataire="0692ZZZZZZ"; //Séparer par une , si plusieurs destinataires
$expediteur=""; //Indiquer un expéditeur si différent du compte
$message="Bonjour ceci est un test !";
//----- Ne nécessite pas de modification -----
$adresse="http://ylangsms.fr/send-sms.php?compte=$compte";
$adresse.="&code=$code&destinataire=$destinataire&expediteur=";
$adresse.=urlencode($expediteur)."&message=".urlencode($message);
$handle = fopen($adresse, "r");
$data='';
while(!feof($handle))
$data.=fread($handle,256);
fclose($handle);
//---- Suite du traitement à faire vous même ----
// Vous pouvez désactiver la ligne ci-dessous en plaçant // au début
echo $data; //Le résultat de la requête est contenu dans la variable $data
?>
|
