API Igor SMS Gateway

Chaque requête est authentifiée avec votre clé API. Retrouvez-la (ou régénérez-la) depuis votre tableau de bord → Clé API. Gardez-la secrète toute personne qui la possède peut envoyer des messages en votre nom.

L'adresse de base pour tous les points d'accès ci-dessous est :

https://api.sms.igortek.com

Ajoutez votre clé API dans l'en-tête Bearer de chaque requête :

Authorization: Bearer YOUR_API_KEY

Une requête sans clé valide, ou avec une clé révoquée (par exemple après une régénération), reçoit une réponse 401 .

POST /api/v1/sms/send

curl -X POST https://api.sms.igortek.com/api/v1/sms/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+237670123456",
    "message": "Your verification code is 482913",
    "webhookUrl": "https://your-app.com/hooks/sms"
  }'

Réponse — 202 Accepted:

{
  "id": "b3f1...",
  "externalId": null,
  "to": "+237670123456",
  "from": "+237690000000",
  "status": "QUEUED",
  "deviceId": "d41a...",
  "createdAt": "2026-09-15T10:00:00"
}

Champs de la requête :

• to — destinataire, format international E.164 (ex : +237670123456). Obligatoire.
• message — jusqu'à 1600 caractères. Obligatoire.
• deviceId — envoyer depuis un appareil précis (BYOD uniquement). Optionnel.
• operator — opérateur préféré (MTN, ORANGE, CAMTEL). Optionnel.
• webhookUrl — reçoit une notification quand le statut de livraison change. Optionnel.
• scheduledAt — date au format ISO-8601 pour un envoi différé. Optionnel.

Vous pouvez aussi envoyer un en-tête X-Idempotency-Key pour renvoyer une requête sans risquer un envoi en double.

POST /api/v1/sms/batch — même structure, dans un tableau messages .

curl -X POST https://api.sms.igortek.com/api/v1/sms/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "to": "+237670000001", "message": "Hello A" },
      { "to": "+237670000002", "message": "Hello B" }
    ]
  }'

Renvoie un tableau avec la même réponse par message que l'envoi simple.

GET /api/v1/sms/{id} — retrouvez n'importe quel message via l'identifiant reçu à l'envoi.

curl https://api.sms.igortek.com/api/v1/sms/b3f1... \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /api/v1/sms/history — liste paginée de tout ce que vous avez envoyé (?page=0&size=20).

GET /api/v1/sms/inbox — messages reçus sur votre ou vos appareils (BYOD), même pagination.

Ajoutez un webhookUrl en envoyant un message pour recevoir une notification à chaque changement de statut de livraison (en attente → envoyé → livré, ou échoué). Votre serveur doit répondre rapidement avec un code 200 — traitez cette notification comme une information, pas comme une étape obligatoire de votre propre logique.

Les erreurs suivent toujours la même structure :

{
  "error": "INVALID_KEY",
  "message": "Clé API invalide",
  "status": 401,
  "timestamp": "2026-09-15T10:00:00"
}

Codes fréquents :

• 401 — clé API manquante ou invalide.
• 403 — abonnement inactif, ou quota épuisé (Cloud Pool).
• 429 — trop de requêtes envoyées trop vite patientez avant de réessayer.
• 409 — conflit avec une règle métier (ex : quota de devices atteint).

Les limites d'envoi s'appliquent par clé API. Si vous recevez souvent des erreurs 429, pensez à grouper vos envois, ou contactez le support pour une formule plus élevée.

Avec une formule BYOD, votre propre téléphone Android sert de passerelle SMS. Une fois votre abonnement actif, téléchargez l'application à tout moment depuis votre tableau de bord — nous vous envoyons aussi le lien par email dès l'activation.

1. Téléchargez le fichier .apk sur le téléphone à utiliser comme passerelle.
2. Si Android bloque l'installation, autorisez « Installer depuis une source inconnue » pour votre navigateur ou gestionnaire de fichiers, puis réessayez.
3. Ouvrez l'application et entrez l'adresse du serveur, puis le numéro de téléphone associé à votre compte.
4. Demandez un code de connexion : il arrive par SMS. Si le numéro n'est pas encore associé à votre compte, vous recevez un lien par email à la place.
5. Saisissez le code à 6 chiffres. L'application s'authentifie toute seule et récupère son propre jeton d'appareil : il n'y a plus aucun secret à copier depuis le tableau de bord.
6. Laissez l'application ouverte — le téléphone apparaît alors comme appareil sur votre page Appareils dès qu'il est en ligne.

Chaque formule a une limite d'appareils — consultez Appareils pour voir la vôtre. Besoin d'aide ? Contactez le support.