Envoyer un SMS


Comment envoyer un sms

Pour envoyer un sms vous devez poster les informations suivantes en JSON. En utilisant l'url fourni par CinetPay: https://api-notitia.cinetpay.com/sms/1/text/single

paramètre en En-tête

Clé Valeur
Content-Type application/json
Authorization App monapikey

paramètre du corps

Paramètre Type Obligatoire Description
from String oui Représente l'ID de l'expéditeur et peut être alphanumérique ou numérique. La longueur de l'identifiant alphanumérique de l'expéditeur doit être comprise entre 3 et 11 caractères (exemple : nom de la société). La longueur de l'ID numérique de l'expéditeur doit être comprise entre 3 et 14 caractères.
to Array oui Tableau des adresses de destination des messages. Si vous souhaitez envoyer un message à une destination, une seule chaîne est prise en charge au lieu d'un tableau. Les adresses de destination doivent être au format international (Exemple : 41793026727).
text String oui Texte du message qui sera envoyé

Exemple de requête

Exemple Php

 <?php

    function curlPost()
    {
        $curl = curl_init();

        curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://api-notitia.cinetpay.com/sms/1/text/single',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS =>'{
            "from":"CinetPayDemo",
            "to":["2250758712792"],
            "text":"Ceci est un text pour les sms"
        }',
        CURLOPT_HTTPHEADER => array(
            'Authorization: App 7c95244ccfd654bdb51bf52821b25gh67f-fbf9cc4d-1cfd-482e-a921-694bb499db80',
            'Content-Type: application/json'
        ),
        ));

        $response = curl_exec($curl);

        curl_close($curl);
        echo $response;

        return json_decode($response);
    }

    curlPost(); 

Réponse requête

Exemple de réponse succès

{
    "messages": [
        {
            "to": "2250758712792",
            "status": {
                "groupId": 1,
                "groupName": "PENDING",
                "id": 7,
                "name": "PENDING_ENROUTE",
                "description": "Message sent to next instance"
            },
            "messageId": "34426316966003536518",
            "smsCount": 1
        }
    ]
}

Exemple de réponse erreur

Si vous essayez d'envoyer un message sans autorisation, vous recevrez une erreur 401 Unauthorized.

{
  "requestError": {
    "serviceException": {
      "messageId": "UNAUTHORIZED",
      "text": "Invalid login details"
    }
  }
}

Si vous essayez n'avez pas suffisamment de credit , vous obtiendrez ce message

{
    "messages": [
        {
            "to": "2250758712792",
            "status": {
                "groupId": 5,
                "groupName": "REJECTED",
                "id": 12,
                "name": "REJECTED_NOT_ENOUGH_CREDITS",
                "description": "Not enough credits"
            },
            "messageId": "34431579683903536497",
            "smsCount": 1
        }
    ]
}