Cette API permet de connaitre le crédit restant sur un compte ou un sous-compte.
Le point d'entrée est : https://www.eml-srv.com/_api_rest/api_sms_credits
Table des matières
Authentification
L'API est au format REST et est accessible à l'aide d'une authentification HTTP Basique.
Fonctionnement de l'authentification
Si votre nom d'utilisateur est "monlogin" et votre mot de passe monmotdepasseABC
Vous devez créer la chaine suivante : monlogin:monmotdepasseABC
Puis l'encoder en base 64 : bW9ubG9naW46bW9ubW90ZGVwYXNzZUFCQw==
La propriété suivante devra être ajoutée à votre en-tête HTTP :
"Authorization" : "Basic bW9ubG9naW46bW9ubW90ZGVwYXNzZUFCQw=="
Exemple en PHP avec CURL
Curl permet de gérer facilement l'authentification HTTP BASIC :
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.eml-srv.com/_api_rest/api_sms_credits');
curl_setopt($ch, CURLOPT_USERPWD, "monlogin:motdepasse");
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
$output = curl_exec($ch);
Gestion de la réponse
La réponse est au format JSON.
En cas d'erreur
{"Message":"détail du message d'erreur"}
Les erreurs possibles sont :
- Auth protocol error : le login ou le mot de passe ne sont pas défini, ou le protocole est erroné
- Auth error : le protocole est correct mais les identifiants sont faux
- Unknown error - no id : erreur système interne
En cas de réussite
Le nombre de crédit est associé à la variables "credits".
Exemple : {"credits":"3543"}