Envoi de SMS simple

Définition

Il s’agit de l’envoi simple de SMS. Vous pouvez spécifier plusieurs numéro de téléphone dans le paramètre “sms_recipients” en les séparant par une “,”.
Une bonne utilisation consiste à transmettre des trames de 200 à 500 numéros à la fois lors de vos campagnes :

< 200 : vous multipliez les appels et gaspillez le temps de connexion
> 500 : la trame devient lourde et les risques de pertes de données augmentent.

URL

XML : https://www.octopush-dm.com/api/sms

JSON : https://www.octopush-dm.com/api/sms/json

Encodage

UTF-8

Paramètres particuliers

Nom	Définition
user_login	Login utilisateur (adresse e-mail).
api_key	Clé api disponible sur votre manager.
sms_recipients	Liste des numéros au format international +XXZZZZZ, séparés par des virgules.
sms_text	Texte du message (maximum 459 caractères).
sms_type	Type de SMS : XXX = SMS LowCost ; FR = SMS Premium; WWW = SMS Monde. En France, si la mention « STOP au XXXXX » est absente de votre texte, l’API renverra une erreur.
sms_sender	Expéditeur du message (si l’opérateur le permet), 3 à 11 caractères alpha- numériques (a-zA-Z).

Exemple Curl

curl “https://www.octopush-dm.com/api/sms/?user_login=*****%40******.com&api_key=***************&sms_text=un+exemple+de+texte&sms_recipients=0033601010101&sms_type=FR&sms_sender=Octopush“

Retour XML

<?xml version=”1.0″ encoding=”UTF-8″?>
<octopush>
<error_code>000</error_code>
<cost>0.55</cost>
<balance>6.93</balance>
<ticket>api110000000021</ticket>
<sending_date>1501503703</sending_date>
<number_of_sendings>1</number_of_sendings>
<currency_code>€</currency_code>
< successs>
< success>
<recipient>+33601010101</recipient>
<country_code>FR</country_code>
<cost>0.055</cost>
< /success>
< /successs>
< /failures>
</octopush>

Retour JSON

{“error_code“:“000”,”cost“:0.055,”balance“:6.93,”ticket“:“api110000000021”,”sending_date“:1501503703,”number_of_sendings“:1,”currency_code“:“\u20ac”,”failures“:[],”successs“:{“recipient“:33601010101,”country_code“:”FR”,”cost“:0.550,”sms_needed“:1}}

Définition des Tags XML

Se référer à la page concernant les retours XML

* Pour certains utilisateurs ovh, l’utilisation de curl_setopt($ch, CURLOPT_FRESH_CONNECT, true); dans leur séquence d’envoi en CUrl pourrait être utile.