Aller au contenu principal

Documentation API SMS

Guide complet pour intégrer notre API SMS dans vos applications

Introduction

L'API SMS d'Abdaty Tech vous permet d'envoyer des messages SMS au Mali de manière simple et fiable. Notre API REST est facile à intégrer et offre une livraison rapide en moins de 3 secondes.

Base URL

https://api.abdaty-tech.com/v1

Authentification

Toutes les requêtes API nécessitent une clé API valide. Vous pouvez obtenir votre clé depuis votre tableau de bord.

curl -X POST https://api.abdaty-tech.com/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Envoyer un SMS

Endpoint pour envoyer un SMS unique ou en masse.

POST/sms/send

Paramètres

to
string - Numéro de téléphone (+223XXXXXXXX)
message
string - Contenu du message (max 160 caractères)
sender
string (optionnel) - Nom de l'expéditeur (max 11 caractères)

Exemple de requête

{
  "to": "+223XXXXXXXX",
  "message": "Bonjour de Abdaty Tech!",
  "sender": "AbdatyTech"
}

Réponses

Succès (200)

{
  "success": true,
  "messageId": "msg_abc123",
  "status": "sent",
  "to": "+223XXXXXXXX",
  "cost": 20,
  "currency": "FCFA"
}

Codes d'erreur

  • 400 Bad RequestParamètres invalides ou manquants
  • 401 UnauthorizedClé API invalide ou manquante
  • 402 Payment RequiredCrédits insuffisants
  • 429 Too Many RequestsLimite de taux dépassée
  • 500 Internal Server ErrorErreur serveur

Exemples de code

Node.js
const axios = require('axios');

const sendSMS = async () => {
  try {
    const response = await axios.post(
      'https://api.abdaty-tech.com/v1/sms/send',
      {
        to: '+223XXXXXXXX',
        message: 'Hello from Abdaty!',
        sender: 'AbdatyTech'
      },
      {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );
    console.log(response.data);
  } catch (error) {
    console.error(error.response.data);
  }
};

sendSMS();
Python
import requests

url = 'https://api.abdaty-tech.com/v1/sms/send'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'to': '+223XXXXXXXX',
    'message': 'Hello from Abdaty!',
    'sender': 'AbdatyTech'
}

response = requests.post(url, json=data, headers=headers)
print(response.json())