Documentation API — Informatechnique

Introduction

L'API Informatechnique est accessible via https://api.informatechnique.fr/v2. Toutes les communications sont chiffrées via HTTPS.

L'API utilise le format JSON. Rate limit : 100 requêtes/seconde par clé API.

Authentification

Chaque requête doit inclure un header Authorization avec votre token Bearer.

Header HTTP

Authorization: Bearer itk_live_votre_cle_api

Deux types de clés : itk_live_ (production) et itk_test_ (sandbox).

Envoyer un SMS

POST /sms/send

Envoie un SMS à un ou plusieurs destinataires.

Paramètres

Paramètre	Type	Requis	Description
`to`	string	Oui	Numéro au format international
`message`	string	Oui	Contenu du SMS (160 car. max)
`type`	string	Non	"marketing", "transactionnel", "otp"
`sender_id`	string	Non	Expéditeur personnalisé (11 car. max)

Exemple de requête

cURL

curl -X POST https://api.informatechnique.fr/v2/sms/send \
  -H "Authorization: Bearer itk_live_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+33612345678",
    "message": "Votre code de confirmation est 4829",
    "type": "transactionnel",
    "sender_id": "InfoTech"
  }'

Réponse

Réponse JSON

{
  "status": "sent",
  "message_id": "msg_8f4a2b1c9d3e",
  "to": "+33612345678",
  "credits_used": 1,
  "timestamp": "2026-03-01T10:30:00Z"
}

Vérification OTP

POST /otp/send

Envoie un code OTP au numéro spécifié.

Paramètres

Paramètre	Type	Requis	Description
`to`	string	Oui	Numéro au format international
`length`	integer	Non	Longueur du code (4 à 8, défaut : 6)
`expiry`	integer	Non	Durée de validité en secondes (défaut : 300)

POST /otp/verify

Vérifie un code OTP saisi par l'utilisateur.

Paramètres

Paramètre	Type	Requis	Description
`to`	string	Oui	Numéro auquel le code a été envoyé
`code`	string	Oui	Code OTP saisi par l'utilisateur

Webhooks

Configurez des URLs de callback pour recevoir des notifications en temps réel sur vos événements.

Événements disponibles

sms.delivered — SMS délivré au destinataire
sms.failed — Échec de livraison du SMS
otp.verified — Code OTP vérifié avec succès
otp.expired — Code OTP expiré

Exemple de payload

Webhook Payload

{
  "event": "sms.delivered",
  "message_id": "msg_8f4a2b1c9d3e",
  "to": "+33612345678",
  "status": "delivered",
  "delivered_at": "2026-03-01T10:30:05Z",
  "webhook_id": "wh_a1b2c3d4e5"
}

Codes d'erreur

L'API retourne des codes HTTP standard pour indiquer le succès ou l'échec d'une requête.

Code	Statut	Description
`400`	Bad Request	Paramètres manquants ou invalides
`401`	Unauthorized	Clé API manquante ou invalide
`403`	Forbidden	Accès refusé à cette ressource
`404`	Not Found	Ressource introuvable
`429`	Too Many Requests	Rate limit dépassé (100 req/s)
`500`	Internal Error	Erreur interne du serveur

SDKs & Librairies

SDKs officiels disponibles pour les principaux langages de programmation.

Python

pip install informatechnique

Node.js

npm install @informatechnique/sdk

PHP

composer require informatechnique/sdk

Go

go get github.com/informatechnique/sdk-go