Documentation API

Bienvenue dans la documentation de l'API APISMS. Cette API vous permet d'envoyer des SMS en masse vers les numéros gabonais (Airtel & Moov).

Base URL

https://apisms.gene6.ga/api

Format

JSON

Authentification

L'API APISMS utilise des clés API pour l'authentification. Vous devez inclure votre clé API dans l'en-tête X-API-Key de chaque requête.

Important: Gardez votre clé API secrète. Ne la partagez jamais publiquement et ne l'incluez pas dans votre code côté client.

Obtenir votre clé API

Connectez-vous à votre tableau de bord
Accédez à la section "Clés API"
Cliquez sur "Nouvelle clé API"
Donnez un nom à votre clé et cliquez sur "Créer"
Copiez votre clé (elle ne sera affichée qu'une seule fois)

Utilisation

X-API-Key: apisms_your_api_key_here

Envoyer un SMS

POST/api/v1/sms

Paramètres

Paramètre	Type	Requis	Description
MSISDN	string	Oui	Numéro de téléphone au format 241XXXXXXXX (11 chiffres)
TEXT	string	Oui	Contenu du SMS (max 1600 caractères)
SENDER	string	Oui	Nom de l'expéditeur (max 11 caractères)

Exemple de requête

POST /api/v1/sms
X-API-Key: apisms_your_api_key_here
Content-Type: application/json

{
  "MSISDN": "24177123456",
  "TEXT": "Bonjour depuis APISMS!",
  "SENDER": "YourBrand"
}

Réponse réussie (200)

{
  "status": "SUCCESS",
  "message": "SMS sent successfully",
  "data": {
    "message_id": "f2f8d24a-dee7-49d2-976a-33a8b6c95311",
    "provider_message_id": "1761413563136-6ae3dc8e",
    "msisdn": "24177123456",
    "status": "sent"
  },
  "processing_time_ms": 3380
}

Exemples de code

Voici des exemples d'intégration dans différents langages de programmation.

curl -X POST https://apisms.gene6.ga/api/v1/sms \
  -H "X-API-Key: apisms_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "MSISDN": "24177123456",
    "TEXT": "Bonjour depuis APISMS!",
    "SENDER": "APISMS"
  }'

Codes d'erreur

Code	Message	Description
400	Bad Request	Paramètres manquants ou invalides
401	Unauthorized	Clé API invalide ou manquante
402	Payment Required	Crédits insuffisants
404	Not Found	Profil utilisateur non trouvé
500	Internal Server Error	Erreur serveur interne

Limites et quotas

✓

Limite de débit

100 requêtes par minute par clé API

✓

Longueur du message

160 caractères = 1 SMS. Les messages plus longs sont automatiquement divisés et facturés en conséquence.

✓

Format de numéro

Les numéros doivent être au format 241XXXXXXXX (11 chiffres, sans le +)

✓

Opérateurs supportés

Airtel Gabon (07/77) et Moov Gabon (06/76)

Besoin d'aide?

Notre équipe est là pour vous aider à intégrer l'API APISMS dans vos projets.

Contacter le support