Guide d'intégration

Intégrez l'API SMSGET en quelques minutes
Retour
1
Obtenez vos identifiants API

Connectez-vous à votre espace client SMSGET pour générer vos clés d'API.

Clé API (token) : sk_xxxxxxxxxx
Secret : ss_xxxxxxxxxxxxxxxxxxxx
Important : Gardez vos identifiants sécurisés. Ne les partagez jamais et ne les exposez pas dans votre code source.
Se connecter S'inscrire
2
Base URL et authentification

Toutes les requêtes doivent être envoyées à la base URL suivante :

https://smsget.tech/api/v1

Authentifiez-vous en incluant vos identifiants dans les headers : 

X-API-Key: sk_xxxxxxxxxx
X-API-Secret: ss_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
3
Envoyer un SMS

Utilisez l'endpoint /sms/send pour envoyer un SMS.

Endpoint : POST /sms/send
Paramètres de la requête
Paramètre Type Obligatoire Description
recipient string ✅ Oui Numéro du destinataire (ex: +243843001380)
message string ✅ Oui Contenu du SMS (max 640 caractères)
sender_name string ❌ Non Nom de l'expéditeur (max 11 caractères)
Exemple de requête
curl -X POST "https://smsget.tech/api/v1/sms/send" \
  -H "X-API-Key: sk_xxxxxxxxxx" \
  -H "X-API-Secret: ss_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "+243843301387",
    "message": "Bonjour, ceci est un test SMSGET !",
    "sender_name": "MonApp"
  }'
Réponse
{
  "success": true,
  "message": "SMS envoyé avec succès",
  "data": {
    "message_id": "msg_abc123",
    "recipient": "+243843301387",
    "sender_name": "MonApp",
    "units_used": 1,
    "balance_remaining": 999,
    "status": "sent"
  }
}
4
Vérifier votre solde

Consultez votre solde de SMS à tout moment.

Endpoint : GET /balance
Exemple de requête
curl -X GET "https://smsget.tech/api/v1/balance" \
  -H "X-API-Key: sk_xxxxxxxxxx" \
  -H "X-API-Secret: ss_xxxxxxxxxxxxxxxxxxxx"
Réponse
{
  "success": true,
  "data": {
    "balance": 999,
    "total_purchased": 1000,
    "total_used": 1,
    "currency": "SMS"
  }
}
5
Consulter l'historique

Récupérez l'historique de vos SMS envoyés.

Endpoint : GET /sms/history
Paramètres optionnels
Paramètre Type Description
limit integer Nombre de résultats (défaut: 20, max: 100)
page integer Numéro de page pour la pagination
status string Filtrer par statut (sent, delivered, failed)
Exemple de requête
curl -X GET "https://smsget.tech/api/v1/sms/history?limit=10&status=sent" \
  -H "X-API-Key: sk_xxxxxxxxxx" \
  -H "X-API-Secret: ss_xxxxxxxxxxxxxxxxxxxx"