Notre API SMS, simple et facile API HTTP

Cette page fournit une référence pour toutes les fonctionnalités disponibles via l'interface HTTP pour l'envoi et le réception de SMS.
L'API HTTP vous permet d'intégrer votre système (client) à ROOTSMS en utilisant le protocole HTTP pour envoyer des SMS. HTTPS est également pris en charge pour les transactions sécurisées utilisant le cryptage SSL.
Le client émet une requête HTTP GET ou POST à l'interface ROOTSMS HTTP fournissant une liste des paramètres requis. Notre système renvoie une réponse HTTP qui indique l'état du message envoyé.

Vous pouvez envoyer des SMS et aussi lister les SMS reçu sur votre numéro dédié
Envoyer un SMS :
URL : https://api.rootsms.com/sendsms/
Paramètres Description Obligatoire
recipients Numéro du destinataire au format international Oui
message Le contenu du SMS à envoyer au destinataire Oui
apikey La clé API unique liée à votre compte Oui
Lister les SMS reçus :
URL : https://api.rootsms.com/getsms/
Paramètres Description Obligatoire
apikey La clé API unique liée à votre compte Oui
N'est plus utilisé
/SENDSMS
Réponses possible lors de l'expédition d'un SMS :
Code Description
0 Le message est envoyé sans erreur
6 Temps de processus dépassé
7 Le message n'est pas envoyé
30 Erreur interne - Contactez le support technique
40 L'API KEY est désactivée
60 L'API KEY est manquante
50 L'API n'est pas correcte
70 Nombre d'envoi multiple via la même requête : 4 numéros
80 Votre compte ne permet pas un envoi multiple
99 Le pays de destination n'est pas joignagle pour le moment
100 Dépassement de la limite d'envoi d'un SMS par minutes (dépend de votre api key et option


/RESENDSMS
Réponses possible lors de l're-expédition d'un SMS):
Code Description
200 id message manquant
201 id message n'existe pas
202 le message est déjà bien envoyé


Tester ici votre API KEY
Afficher la liste des pays joignables
Demander une API KEY gratuite
ENVOYER UN SMS : /SENDSMS
//3 paramètres obligatoires
$phonenumber = "0032494000000";
$message = "Hello World";
$apikey = "3bae4f51b8b8fd266987c.......";

$URL = "https://api.rootsms.com/sendsms/?recipients=$phonenumber&message=$message&apikey=$apikey";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
echo $output;
curl_close($ch);


RENVOYER UN SMS EN ATTENTE : /RESENDSMS
//2 paramètres obligatoires
$apikey = "3bae4f51b8b8fd266987c.......";
$id = "123456789465465.....";
$URL = "http://api.rootsms.com/resendsms/?apikey=$apikey&id=$id";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
echo $output;
curl_close($ch);


LISTER LES SMS RECUS : /GETSMS
//2 paramètres obligatoires
$apikey = "3bae4f51b8b8fd266987c.......";

$URL = "http://api.rootsms.com/getsms/?apikey=$apikey";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);
echo $output;
curl_close($ch);
ENVOYER UN SMS :
Utilisez l'adresse mail unique liée à votre API KEY (voir dans votre interface de gestion).

Par exemple :
  • Envoyer un mail à l'adresse 1234567910@mailtosms.co (votre adresse mail unique)
  • Avec comme object : le numéro de téléphone du destinataire
  • Avec comme corps de message : le contenu du sms à envoyer
C'est tout ! C'est aussi simple que ça.



ENVOYER UN SMS : /SENDSMS
URL du WebService : https://api.rootsms.com/sendsms/wsdl/sendSmsNow.wsdl

require_once "lib/nusoap.php";
$client = new nusoap_client("sendSmsNow.wsdl", true);
$error = $client->getError();
$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

$finalOut = '
< error >'.$result['return']['error'].'< /error >
< sent >'.$result['return']['sent'].'< /sent >
< id >'.$result['return']['id'].' ';< /id >

echo $finalOut;
ENVOYER UN SMS : /SENDSMS
ResLancement = HTTPRequête("https://api.rootsms.com/sendsms/")
SI ResLancement = Vrai ALORS
ResCode = HTTPDonneRésultat()
Info("Code HTML : " + ResCode)
FIN
Il est possible de tester l'intégration et la bonne configuration de votre api via ce lien : https://api.rootsms.com/sendsms/test/
Le saviez-vous ? vous pouvez supprimer rapidement l'historique des SMS envoyés.
Louer un serveur SMS