Message unitaire

Cette méthode vous permet d'envoyer un message unitaire à un destinataire.

GET

/send

Paramètres de requête

token
requis si absent des headers
 Votre token
text
requis
 Votre message
to
requis
 Votre destination
pushtype Le type d'envoi (alert ou marketing)
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

Exemple prêt à l'emploi


https://api.smsfactor.com/send?text=Hello world&to=33612345678&token=your.token

Exemples détaillés Avec le token dans les headers, puis dans l'URL


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

GET /send?text=Hello world&to=33612345678&token=your.token&delay=2025-05-18 10:00:51
Host: api.smsfactor.com
Accept: application/json

Format de la réponse


{
  "status": 1,
  "message": "OK",
  "ticket": "14672468",   //The id of your campaign
  "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>
  <ticket>14672468</ticket>
  <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>