Statut unitaire

Cette requête permet de récupérer le statut d’un SMS.

URL

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

Paramètres obligatoires

Nom
Valeur

messageId

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

phoneNumber

Numéro de téléphone portable du destinataire

Paramètres optionnels

Nom
Valeur

_format

json ou xml

Requêtes

<?php
 
        // Prepare data for GET request
        $data = 'apiKey=YOUR_API_KEY&messageId=300&phoneNumber=06xxxxxxxx';
 
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/message-status?'.$data);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_TIMEOUT, 10);
 
 
        $result = curl_exec($curl);
        curl_close($curl);
 
        // Process your response here
        echo $result;
?>

Réponse

{
    "success": true,
    "code": 200,
    "number": "0600000000",
    "messageId": "1111",
    "stopSms": false,
    "date": "2015-02-07 22:39:46",
    "statut": "Delivered",
    "cost": 0.045,
    "countryCode": "FR",
    "currency": "EUR"
}
  • 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

2

Le numéro de téléphone est requis

3

L'ID du message est requis

4

Message introuvable

10

Clé API incorrecte

200

Tout s’est bien passé !

Dernière mise à jour