Référence
Authentification
Authentification par clé API et limites HTTP par plan.
Base URL : https://sandbox-api.reachflow.me/api/v1
Chaque requête doit inclure l’en-tête X-API-Key avec une clé live ou test créée dans le dashboard (menu API → Clés API).
Les clés portent des scopes (messages:send, messages:read, providers:read, otp:send, otp:verify). Un endpoint renvoie 403 insufficient_scope si le scope requis est absent.
Prérequis : plan Starter ou supérieur, ou add-on Accès API sur le plan Gratuit.
Scopes
Scopes disponibles
| Nom | Type | Description |
|---|---|---|
| messages:send | scope | POST send, send-media, send-bulk |
| messages:read | scope | GET statut message |
| providers:read | scope | GET providers |
| otp:send | scope | POST /otp/send |
| otp:verify | scope | POST /otp/verify |
Limites de débit HTTP
Compteur par clé API, fenêtre glissante d'une minute. Au-delà : 429 rate_limit_exceeded.
| Plan | Limite HTTP |
|---|---|
| Gratuit + add-on API | 15 req/min |
| Starter | 30 req/min |
| Pro | 120 req/min |
| Business | 500 req/min |