Manuel intégration API SMS version 1.
0 R1
[Link]/bulksms
L’API SMS BulkSMS est basée sur une méthode https se qui permet son intégration simple et
rapide. Vous pouvez utiliser n’importe quel client https dans n’importe quel langage.
https Request
https
Response
Client API
Consumer SMS Server
Architecture de base
L’url de base est:
[Link] où version représente la version de l’API.
Requête de push
L’api suivante vous permet d’envoyer un SMS à travers la méthode https POST.
Url [Link]
Method POST
Content-Type application/x-www-form-urlencoded
Body api_key=maclédapi&password=monpasse&message=monmessage&sender=test&phone=237694124344
Paramètres d’api
Paramètres de la requête
Les paramètres suivant doivent être envoyés par post.
api_key Obligatoire Clé d’API tel que définit dans votre compte
password Obligatoire Mot de passe identique à celui utilisé lors de la connexion à BulkSMS
message Obligatoire Message à envoyer
sender Obligatoire Sender ID il s’agit de l’identifiant de l’émetteur du message
phone Obligatoire Numéro de téléphone du destinataire
flag Optionnel Type de message à envoyer. long_sms pour les sms de plus de 160 caractères. Lorsque ce
champ n’est pas précisé sa valeur par défaut est à short_sms
Paramètres d’api
Réponse du push
La réponse à la requête est au format json clé/valeur contenant une clé status qui décrit le statut de la requête.
https Status code: 200
status Ce champ est à success lorsque le message a bien été envoyé et à error en cas d’erreur.
message Contient le message lié au status du push
errors Ce champ lorsqu’il est définit dans la réponse contient les erreurs liés aux paramètres de la requête à
savoir paramètre mal formaté ou inexistant
Exemple réponse avec status success Exemple réponse avec statut error
Paramètres d’api
Envoi d’un sms court le champ flag est
positionné à short_sms. Par défaut ce
champ est définit sur short_sms lorsqu’il
est ignoré dans les paramètres
Exemple d’integration avec curl php
Envoi d’un sms long (Plus de 160
caractères) le champ flag est positionné à
long_sms.
Exemple d’integration avec httrequest php
Exemple d’integration avec java okclient
Comment obtenir sa clé d’api de la plateforme bulksms
Pour toute information notre équipe reste à la disposition des intégrateurs
pushsms@[Link]
Information