API MMS

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

<?php

$url = "https://macsmspro.com/api/mms_v2";


$fields = array(
    
    "name" => "MIASHOP", //name of your message
    "telephone" => "447745212xxx", //  recipient phone
    "message" => "Adidas Shoes is now available....", //  body of message
    "token" => "$2yxxxxxxxxxxxxxxxxxxxxxx", // api token 
    "files" => array(                   
        "url_image_1",
        ...
        "url_image_n",   // medias 
    )                 
);



$curl_options = array(
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query( $fields ),
    CURLOPT_HTTP_VERSION => 1.0,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => false
);

$curl = curl_init();
curl_setopt_array( $curl, $curl_options );
$result = curl_exec( $curl );

curl_close( $curl );



$response = json_decode($result);

echo "<pre>";
var_dump($response);
echo "</pre>";

?>

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

Le champ files est facultatif.

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.

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

 {"success":
   {
    "delivered_status":"SUCCESSFUL",
    "sent_from":"MIASHOP",
    "sent_to":"447745212xxx",
    "msg_body":"Adidas Shoes is now available....",
    "credits_used":0.80,
    "remaining_credits":305.48,
    "authorize_attachment":"True",
    "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-20 15:55:57",
    "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",
    "source":"MMS API"
   }
}

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 

authorize_attachment // booléen qui indique l'autorisation pièce jointe

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.

source  // Canal API utilisé 

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_MMS_ID_SENDER

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

MMS_NOT_SENT

SMS non envoyé. Code erreur : 422

ERROR_CARRIER

Erreur réseau. Code erreur: 500