Codes Retour de l’API SMS
Le choix du XML
L’API SMS Octopush vous renverra en retour un XML contenant :
- Le code retour de l’API
- Coût de la campagne ou, dans le nœud « successs » : coût de l’envoi.
- Votre solde résiduel juste après l’envoi
- La liste des numéros que vous avez transmis, avec le coût dans votre devise pour chaque numéro, et le code erreur associé.
Exemple
<?xml version=”1.0″ encoding=”UTF-8″ ?>
<octopush>
<error_code>000</error_code>
<cost>0.105</cost>
<balance>6.93</balance>
<ticket>api110000000021</ticket>
<sending_date>1326311820</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.0550</cost>
</success>
</successs>
<failures>
<failure>
<error_code>150</error_code>
<recipient>+334</recipient>
</failure>
<failure>
<error_code>150</error_code>
<recipient>+335</recipient>
</failure>
<failure>
<error_code>150</error_code>
<recipient>+336</recipient>
</failure>
</failures>
</octopush>
Définition des Tags XML
Code
Définition
cost
Coût de la campagne ou, dans le nœud « successs » : coût de l’envoi.
balance
Votre solde résiduel.
ticket
Votre ticket d’envoi. Permet d’identifier votre campagne, et de récupérer les AR si vous avez choisi le type « Premium ».
sending_date
Date de début d’envoi prévu de la campagne
number_of_sendings
Nombre de sms nécessaires en fonction de la taille du texte, du nombre de SMS, et du type de SMS (avec caractères Unicode : 1 SMS tous les 70 caractères ; 1 SMS jusqu’à 160 caractères ; 1 SMS tous les 137 caractères si le SMS dépasse 160 caractères).
currency_code
Monnaie de tarification de vos SMS.
successs
Listes des numéros traités comme valides, et facturés.
recipient
Numéros de téléphones formatés.
country_code
Pays du numéro de téléphone.
failures
Liste des numéros erronés.