API HSMS - Documentation

Vous pouvez consulter le nombre total de SMS disponible au sein de chacune de vos applications en formulant une requête de type POST comme celle-ci :

Method : POST

URL : https://hsms.ci/api/check-sms/

Authorization : "bearer Token ( Disponible au sein de votre Tableau de bord HSMS )"

clientid : Identifiant de l'application concernée ( Disponible au sein de votre Tableau de bord HSMS )

clientsecret : Mot de passe de l'application concernée ( Disponible au sein de votre Tableau de bord HSMS )

Formulation de la requête

                            curl --location --request POST 'https://hsms.ci/api/check-sms/' \
                            -H 'authorization : Bearer TjJ4ZTd4emsyNUZaRW5TMFlnbWxEMTBhOnhwUERza0JJOUdLcGJQamtISnJBTjZRYQ==' \
                            -H 'content-type : application/form-data' \
                            -d 'clientid=BOULANGERIE_fbjrgfjbjnjvfvj & clientsecret=bf5b6873bc2e6e020d5bec0ad818ceb4bab605' \

                          

Reponse attendue :

                            {
                                "SMS disponibles": 0,
                                "Application": "JK LIVRAISON"
                            }

                          

Rien de plus simple que l'envoi de sms avec l'APi de HSMS , afin d'y arriver , vous devez formuler une requete de type POST comme celle-ci :

Vous pouvez consulter le nombre total de SMS disponible au sein de chacune de vos applications en formulant une requête de type POST comme celle-ci :

Method : POST

URL : https://hsms.ci/api/envoi-sms/

Authorization : "bearer Token ( Disponible au sein de votre Tableau de bord HSMS )"

clientid : Identifiant de l'application concernée ( Disponible au sein de votre Tableau de bord HSMS )

clientsecret : Mot de passe de l'application concernée ( Disponible au sein de votre Tableau de bord HSMS )

telephone : liste des numeros séparés d'une virgule, vous ne devez pas ajouter d'espaces , ni d'autres symboles entre les numéros ( Exemple: 2250789889494,2250789426868)

message : le message à envoyer au(x) destinataire(s)

NB : Le nombre de message s'incrémente à chaque 160 caractères, par exemple si vous envoyez un message de 161 caractères total, le sytème vous facturera 2 SMS.

Formulation de la requête

                            curl --location --request POST 'https://hsms.ci/api/envoi-sms/' \
                            -H 'authorization : Bearer TjJ4ZTd4emsyNUZaRW5TMFlnbWxEMTBhOnhwUERza0JJOUdLcGJQamtISnJBTjZRYQ==' \
                            -H 'content-type : application/form-data' \
                            -d 'clientid=BOULANGERIE_fbjrgfjbjnjvfvj & clientsecret=bf5b6873bc2e6e020d5bec0ad818ceb4bab605 & telephone=2250789889555,2250505500220,2250160709894 & message=bonjour ' \

                          

Reponse en cas d'envoi reussi :

                            {"message":"Tous vos SMS ont bien été envoyés", "success":True}
                            
                            status code = 201

                          

l'API de HSMS vous permet d'envoyer des SMS depuis votre site internet ou votre application mobile, simple et facile à integrer à vos projets.

Pour des raisons de sécurité, chacune de vos requêtes doit être accompagnée d'un Token , il est par defaut disponible sur tous les comptes HSMS , vous pouvez aussi le renouveler :

Method : POST

URL : "https://hsms.ci/api/token/"

email : Adresse Email de votre compte HSMS

password : Mot de passe de votre compte HSMS

                          curl --location --request POST 'https://hsms.ci/api/token/' \
                          -H 'content-type : application/form-data' \
                          -d 'email=VOTRE_EMAIL_HSMS & password=VOTRE_MOT_DE_PASSE_HSMS' \
                          
                          

Reponse attendue :

                                {
                                    "success": true,
                                    "message": "OK",
                                    "token": "bf5b6873bc2e6eb90e0d5bec0ad718ceb4bab605"
                                }