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/
Lister les SMS reçus :
URL : https://api.rootsms.com/getsms/
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 |
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 :
/RESENDSMS
Réponses possible lors de l're-expédition d'un SMS):
Tester ici votre API KEY
Afficher la liste des pays joignables
Demander une API KEY gratuite
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);
//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 :
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
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;
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
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.