API Response change on [POST,GET] /send
Scheduled for Jul 2, 10:00 - 10:05 CEST
Scheduled
English version 🇬🇧

From the 2nd of July 2024, the Response Payload of both GET /send and POST /send endpoints will change.

What will change ?

Don’t worry, we’re just adding new fields so you can have more details about the status of your SMS messages. Right now, we’re filtering SMS messages that are either :

- Blacklisted
- NPAI
- Duplicated
- Invalid number
- Flood
- Country not allowed

We’ve put the `flood` and `not_allowed` inside the `invalid` field in the past. We also plan to offer a new way of filtering undesired SMS that will also be available the 1st of July. But we cannot also put that on the `invalid` counter right ? This is no longer a viable solution. So, long story short, we’re adding 3 new fields on the Response so it will look like this :


{
"status": 1,
"message": "OK",
"ticket": "14672468", //The id of your campaign
"cost": 2, //The cost of your campaign
"credits": 642, //Your credits after your campaign has been created
"total": 2, //Number of message before filtering
"sent": 2, //Number of message after filtering
"blacklisted": 0, //Number of blacklisted numbers
"duplicated": 0, //Number of duplicated numbers
"invalid": 0, //Number of invalid numbers
"npai": 0 //Number of npai numbers
"flood": 0, //Number of SMS filtered by anti-flood
"not_allowed": 0, //Number of SMS sent to a not allowed country
"country_limit": 0 //Monthly limit for this country reached
}


Instead of this :

{
"status": 1,
"message": "OK",
"ticket": "14672468", //The id of your campaign
"cost": 2, //The cost of your campaign
"credits": 642, //Your credits after your campaign has been created
"total": 2, //Number of message before filtering
"sent": 2, //Number of message after filtering
"blacklisted": 0, //Number of blacklisted numbers
"duplicated": 0, //Number of duplicated numbers
"invalid": 0, //Number of invalid numbers
"npai": 0 //Number of npai numbers
}


If you have any any question please contact us as support@smsfactor.com

Version française 🇫🇷

À partir du 2 juillet 2024, la réponse de l’API des endpoints GET /send et POST /send va changer.

Qu'est-ce qui va changer ?

Ne vous inquiétez pas, nous ajoutons simplement de nouveaux champs pour que vous puissiez avoir plus de détails sur l'état de vos SMS. Actuellement, nous filtrons les SMS qui sont :

- Sur liste noire
- NPAI
- En double
- Numéro invalide
- Flood
- Pays non autorisé

Nous avons précédemment placé les éléments `flood` et `not_allowed` à l'intérieur du champ `invalid`. Nous prévoyons également d'offrir une nouvelle façon de filtrer les SMS indésirables, qui sera également disponible à partir du 1er juillet. Mais nous ne pouvons pas non plus inclure cela dans le compteur `invalid`, n'est-ce pas ? Ce n'est plus une solution viable. Donc, pour résumer, nous ajoutons 3 nouveaux champs à la réponse, qui auront l'aspect suivant :

{
"status": 1,
"message": "OK",
"ticket": "14672468", //L'identifiant de votre campagne
"cost": 2, //Le coût de votre campagne
"credits": 642, //Vos crédits après la création de votre campagne
"total": 2, //Nombre de messages avant filtrage
"sent": 2, //Nombre de messages après filtrage
"blacklisted": 0, //Nombre de numéros sur liste noire
"duplicated": 0, //Nombre de numéros en double
"invalid": 0, //Nombre de numéros invalides
"npai": 0, //Nombre de numéros NPAI
"flood": 0, //Nombre de SMS filtrés par anti-inondation
"not_allowed": 0, //Nombre de SMS envoyés vers un pays non autorisé
"country_limit": 0 //Limite mensuelle atteinte pour ce pays
}

Au lieu de :

{
"status": 1,
"message": "OK",
"ticket": "14672468", //L'identifiant de votre campagne
"cost": 2, //Le coût de votre campagne
"credits": 642, //Vos crédits après la création de votre campagne
"total": 2, //Nombre de messages avant filtrage
"sent": 2, //Nombre de messages après filtrage
"blacklisted": 0, //Nombre de numéros sur liste noire
"duplicated": 0, //Nombre de numéros en double
"invalid": 0, //Nombre de numéros invalides
"npai": 0 //Nombre de numéros NPAI
}


Si vous avez des questions, n’hésitez pas à nous contacter à l’adresse support@smsfactor.com.
Posted Mar 21, 2024 - 12:26 CET
This scheduled maintenance affects: API.