Envoi automatisé de SMS par HTTP
Notre HTTP API vous permet d'intégrer facilement
l'envoi SMS dans vos
logiciels, applications ou sites internet tout en
bénéficiant de toutes les options de
note plateforme SMS.
Configuration requise :
php
>=5.6
Étapes :
- Se connecter à votre compte SMS depuis
notre plateforme
https://smsplus.tn/websms/, activer l'accès API en générant votre propre clé API puis télécharger le fichier CLASS "Class_API.php" qui doit être renseigné.
require_once 'Class_API.php';
$apikey = 'mettre votre clé API ici';
- Mettre votre entête (nom d'expéditeur)
devant le paramètre "$from".
$from = 'votre entête ici';
- Le numéro du destinataire. Le numéro
doit commencer par le code pays (ex : 216
pour la Tunisie ; 33 pour la France)
$destination = 'le numéro de votre destinataire';
- Url API
$url = 'https://smsplus.tn/websms/netplus/api';
- Le
texte de votre message
$sms = 'Votre message ici';
- La
requête de votre message
$s_body = array(
'apikey' => $apikey,
'to' => $destination,
'from' => $from,
'sms' => $sms,
);
- Requête API
$user = new NETPLUSSMSAPI();
- Envoyer votre SMS via API
$response = $user->send_sms($s_body, $url);
- 2
Ways : Réception SMS
$get_in=$user->get_in($apikey,$url);
- Crédit SMS
restant
$balance=$user->ch_balance($apikey,$url);
- La réponse de notre API est au forma
json:{"statut":"message":"Envoyé avec succès"}
Exemple d'intégration en PHP
// Vous pouvez exécuter cet exemple en 3 façons différentes:
// 1. Enregistrez ces lignes de code sous le nom "exemple.php" puis l'exécutez avec la ligne de commande.
//
// 2. Téléchargez le fichier "exemple.php" sur un espace d'hébergement (mon-site-web.com) puis chargez
// le fichier php dans votre navigateur Web : mon-site-web.com/exemple.php
//
// 3. Installez un serveur local comme WAMP, MAMP ou XAMPP. Téléchargez le fichier "exemple.php" dans la
// racine Web puis chargez "localhost:8888/exemple.php" dans votre navigateur Web.
require_once 'Class_API.php';
use NETPLUSSMSAPI;
$apikey = 'mettre
votre clé API ici';
// Changez
l'entête, ci-dessous, par celui qui vous
convient : votre nom d'enseigne.
$from = 'NetPlus';
// Indiquer le
numéro de téléphone mobile de votre
destinataire.
$destination = '21626911733';
// Adresse URL de
notre HTTP API.
$url = 'https://smsplus.tn/websms/netplus/api';
// Texte de votre
message
$sms = 'Votre message ici';
// Création d'une requête
SMS
$s_body = array(
'apikey' => $apikey,
'to' => $destination,
'from' => $from,
'sms' => $sms,
);
// Requête SMS API
$user = new
NETPLUSSMSAPI();
// Envoyer un SMS
$response = $user->send_sms($s_body, $url);
p_r($response);
// Obtenir une
réponse
$response=json_decode($response);
// Afficher un message de
confirmation sur l'écran
echo 'MSG: '.$response->message;
// Consulter les SMS reçus
$get_in=$user->get_in($apikey,$url);
// Consulter votre crédit
SMS restant
$balance=$user->ch_balance($apikey,$url);
Réponse
de la requête HTTP POST
|
Statut |
Message |
|
ok |
Envoi avec succès |
|
100 |
Mauvaise demande |
|
101 |
Mauvaise action |
|
102 |
Authentification échouée |
|
103 |
Numéro de téléphone invalide |
|
104 |
La couverture de l'opérateur n'est pas activée |
|
105 |
Solde insuffisant |