API SMS

L' API est appelée par l'url "https://macsmspro.com/api/sms_v2 " stocké dans la variable $url

 <?php

$url = "https://macsmspro.com/api/sms_v2";
$fields = array(
    
    "name" => urlencode("AUTH"), // name of your message
    "telephone" => urlencode("004478562xxxx"), // recipient phone
    "message" => urlencode("Hello world"), // body of message
    "token" => urlencode("$2yxxxxxxxxxxxxxxxxxxxxxx"), // api token 
);

$fields_string = "";
foreach($fields as $key=>$value) { $fields_string .= $key."=".$value."&"; }


rtrim($fields_string, "&");

$ch = curl_init();

curl_setopt($ch,CURLOPT_URL, $url);
curl_setopt($ch,CURLOPT_POST, count($fields));
curl_setopt($ch,CURLOPT_POSTFIELDS, $fields_string);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);


$result = curl_exec($ch);

curl_close($ch);



$result = json_decode($result);

print_r($result);



?>

Remplacez les valeurs des champ "name", "telephone", "message" et token dans le tableau $fields par les informations spécifiques à votre cas d'utilisation.

Le résultat de la requête est stocké dans la variable $response. Vous pouvez ensuite décoder les données JSON en utilisant json_decode() pour obtenir les informations issues de la réponse API.

Pour faciliter le débogage et la compréhension des données renvoyées par l'API, nous utilisons var_dump($response) pour afficher les résultats dans un format lisible.

Réponse de l'API : Avec le code 200 (success)

 {"success":
   {
     "delivered_status":"SUCCESSFUL",
     "sent_from":"AUTH",
     "sent_to":"004478562xxxx",
     "msg_body":"Hello world",
     "credits_used":0.48,
     "remaining_credits":431.68,
     "sender_ip":"36.121.214.155",
     "sender_user_agent":"Mozilla\/6.0 (Windows NT 10.0; Win64; x64) AppleWebKit\/607.306 (KHTML, like Gecko) Chrome\/205.2.0.0 Safari\/607.30",
     "timestamp":"2023-08-19 15:35:30",
     "sender_url":"example.com/sms/form",
     "sender_used_browser":"Google Chrome",
     "sender_country":"FR",
     "sender_region":"Île-de-France",
     "sender_city":"Paris",
     "sender_location":"48.8567,2.3497",
     "sender_internet_provider":"AS9009 M247 Europe SRL"
     
    }
 }

INTERPRETATION DES RESULTATS

delivered_status // status du message envoyé
Cela indique que le destinataire a reçu le message

sent_from // le nom ID sender emis par l'émetteur

sent_to  // le destinataire du message

msg_body // le corps du message

credits_used //  le crédit utilisé

"remaining_credits // le crédit restant 

sender_ip // adresse IP de l'émetteur du message

sender_user_agent // le user agent de l'émetteur du message

timestamp // l'heure à laquelle le message a été envoyé, heure Royaume-Uni

sender_url // la plateforme sur laquelle la requête a été lancée.
Le système le recupère de façon automatique.

sender_used_browser // le navigateur d'accès utilisé par l'émetteur

sender_country // Le pays dans lequel l'émetteur a envoyé son message

sender_region // La région dans laquelle le message a été envoyé

"sender_city // La ville de l'émetteur

sender_location // coordonnées GPS de de l'émetteur 

sender_internet_provider //   Le fournisseur d'accès internet de l'émetteur.

AUTRES REPONSES RETOURNEES

NAME_IS_REQUIRED

Le nom émetteur ou ID Sender requis. erreur code : 422

ONLY_TEN_LETTERS_IS_REQUIRED_FOR_NAME

Le nom utilisé et validé ne doit contenir que 10 lettres. Code Erreur: 422

THE_RECIPENT_PHONE_NUMBER_IS_REQUIRED

Le numéro de téléphone destinataire est requis. Code erreur 422

THE_MESSAGE_BODY_IS_REQUIRED

Le corps du message est vide. Code erreur 422

TOKEN_REQUIRED

Ce message vous signale que vous essayez de soumettre le formulaire avec le champ token vide

Cette erreur est retournée avec le status 422

INVALID_ACCOUNT ou ACCOUNT_SUSPENDED

Cette erreur es associé au statut code 403

Votre compte n'est pas encore validé(compte invalide) ou votre compte a été suspendu(compte suspendu)

ACCOUNT_NOT_CREDITED

Vous obtenez cet erreur lorsque votre balance est de 0.

Statut code erreur : 403

INSUFFICIENT_CREDIT

Votre crédit est insuffisant . Code erreur : 403

TOKEN_INVALID

Votre token est incorrect. Code erreur: 401

METHOD_NOT_ALLOWED

Accès non autorisé. Code erreur : 405

RECIPIENT_PHONE_IS_UNABLE_TO_RECEIVE_SMS_ID_SENDER

Envoi effectué mais la ligne de votre destinataire n'est pas active.

SMS_NOT_SENT

SMS non envoyé. Code erreur : 422

ERROR_CARRIER

Erreur réseau. Code erreur: 500

MEDIA_LINK_OR_LINK_NOT_AUTHORIZED_PLEASE_TRY_MMS_API

cette erreur indique que l'API SMS n'autorise pas des liens médias.

Dans ce cas veuillez utiliser l' API MMS