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.