Envoi de SMS différé
Définition
Tout envoi via l’API SMS Octopush peut être planifié dans le temps.
Dès que la date que vous avez spécifiée est dépassée, nous faisons partir vos SMS.
La date attendue doit être présentée sous la forme d’un timestamp, au format GMT+1.
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 | (si sms_type != XXX) Expéditeur du message (si l’opérateur le permet), 3 à 11 caractères alpha- numériques (a-zA-Z). |
sms_mode | Mode d’envoi : défaut : 1 1 = Envoi Instantané, 2 = Envoi Différé (il faut alors spécifier la date) |
sending_date | Timestamp, indiqué en GMT+1 |
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&sms_mode=2&sending_date=1455975613«
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>1455975613</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