Simuler un envoi unitaire

Cette méthode vous permet de simuler l'envoi d'un message unitaire. Simuler une campagne vous permet de connaitre le coût ainsi que le nombre de SMS envoyés et filtrés. Cette route ne crée pas réellement de campagne.

GET

/send/simulate

Paramètres de requête

token requis si absent des headers	Votre token
text requis	Votre message
to requis	Votre destination
delay	La date d'envoi `Y-m-d H:i:s`. Doit être dans la timezone `Europe/Paris`
sender	Vous permet de personnaliser l'expéditeur
gsmsmsid	Un id de votre choix pour lier le message à son accusé de réception

Exemples Avec le token dans les headers, puis dans l'URL


GET /send/simulate?text=Hello world&to=33612345678 HTTP/1.1
Host: api.smsfactor.com
Accept: application/json
Authorization: Bearer your.token


GET /send/simulate?text=Hello world&to=33612345678&token=your.token&delay=2025-06-09 10:46:20 HTTP/1.1
Host: api.smsfactor.com
Accept: application/json

Format de la réponse

Une campagne simulée n'est pas réellement créée. Vous ne pourrez pas la récupérer avec la route GET /campaigns


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


<response>
  <status>1</status>
  <message>OK</message>
  <cost>1</cost>
  <credits>642</credits>
  <total>1</total>
  <sent>1</sent>
  <blacklisted>0</blacklisted>
  <duplicated>0</duplicated>
  <npai>0</npai>
  <invalid>0</invalid>
  <not_allowed>0</not_allowed>
  <flood>0</flood>
  <country_limit>0</country_limit>
</response>