Statut multiple

Cette requête permet de récupérer le statut de plusieurs SMS (maximum 500 numéros).

URL

GET https://api.smspartner.fr/v1/multi-status

Les comptes-rendus sont habituellement reçus en quelques secondes après l'envoi du SMS. Cependant, selon les opérateurs et la charge de notre plateforme, ce délai peut parfois aller jusqu'à 48 heures.

Paramètres obligatoires

Nom
Valeur

SMSStatut_List

phoneNumber → Numéros de téléphone des destinataire, la limite sur une seule requête est de 500 numéros. Ils doivent être :

  • au format international (+336xxxxxxxx)

messageId → ID du message. Il se situe dans la réponse de l'envoi.

Paramètres optionnels

Nom
Valeur

_format

json ou xml

Requêtes

<?php
        // Prepare data for POST request
        $fields = array(
            'apiKey'=> 'YOUR API KEY',
            'SMSStatut_List'=>>array(
                array('phoneNumber'=>'+336xxxxxxxx','messageId'=>messageId1),
                array('phoneNumber'=>'+336xxxxxxxx','messageId'=>messageId2)
             )
        );
 
 
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/multi-status');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_TIMEOUT, 10);
        curl_setopt($curl, CURLOPT_POST, 1);
        curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields));
 
        $result = curl_exec($curl);
        curl_close($curl);
 
        // Process your response here
        echo $result;
?>

Réponse

{
    "success": true,
    "code": 200,
    "StatutResponse_List": [
        {
            "success": true,
            "code": 200,
            "phoneNumber": "+33699999993",
            "messageId": 111111,
            "status": "Delivered",
            "date": "1517934416",
            "stopSms": "0",
            "isSpam": "0"
        },
        {
            "success": false,
            "code": 4,
            "phoneNumber": "+33699999992",
            "messageId": 1000,
            "status": "Numéro introuvable"
        },
        {
            "success": false,
            "code": 4,
            "phoneNumber": "+33699999991",
            "messageId": 1222,
            "status": "Numéro introuvable"
        }
    ]
}
  • Delivered (Livré) : Ce statut indique que le message a été livré avec succès au destinataire. Cela signifie que le message a été envoyé correctement et qu’il a été reçu sur l’appareil ou la plateforme du destinataire. La date et l’heure de la réception est normalement disponible.

  • Not delivered (Non livré) : Ce statut fait référence aux messages qui n’ont pas pu être livrés au destinataire. Il peut y avoir plusieurs raisons pour lesquelles un message n’est pas livré : comme un numéro de téléphone non valide ou un problème opérateurs chez un opérateur.

  • Waiting (En attente) : Ce statut indique que le message est en cours de livraison et qu’il n’a pas encore été confirmé s’il sera livré ou non. Cela peut se produire en cas de retards sur le réseau ou lorsque des confirmations supplémentaires sont nécessaires avant de pouvoir marquer le message comme livré ou non livré.

Erreurs

{
    "success": false,
    "code": 10,
    "message": "Clé API incorrecte"
}

Code erreurs

Code de réponse
Réponse

1

La Clé API est requise

4

Message introuvable

10

Clé API incorrecte

Dernière mise à jour