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.