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

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"}