Introduction à l'API ReachFlow
Périmètre de l'API REST v1 et prérequis avant la première requête.
5 min de lecture · Mis à jour le 6 juin 2026
Objectif
Comprendre ce que l'API permet de faire et ce qu'il vous faut avant d'envoyer la première requête.
Prérequis
- Abonnement Starter ou supérieur, ou add-on mensuel Accès API sur le plan Gratuit (détail)
- Au moins un numéro WhatsApp connecté dans ReachFlow
- Une clé API créée dans API → Clés API
Base URL
Les endpoints publics sont préfixés par /api/v1 sur votre instance ReachFlow.
Exemple : https://votre-domaine.reachflow.app/api/v1/messages/send
Authentification
Chaque requête inclut l'en-tête :
X-API-Key: rfl_live_…
Les clés live (rfl_live_…) servent en production sur api.reachflow.me. Les clés sandbox (rfl_sandbox_…) servent sur sandbox-api.reachflow.me pour intégrer et tester avec des plafonds techniques (envois réels possibles).
Périmètre MVP
| Inclus | Hors scope |
|---|---|
| Envoi texte, média, petit lot | Campagnes massives via API |
| OTP send / verify | Règles anti-ban campagne (warm-up, plages) |
Extraction de contenu URL (content:extract) | Indexation RAG automatique |
| Statut message, liste providers | SMS / Email |
Les envois API utilisent la frappe simulée (indicateur « en train d'écrire ») et partagent le quota messages du dashboard avec vos campagnes.
SDK officiels (recommandé)
Pour Node.js et Python, préférez les bibliothèques client plutôt que d'appeler l'API REST à la main :
| Langage | Package |
|---|---|
| Node.js / TypeScript | @reachflow/sdk |
| Python | reachflow |
Elles gèrent l'authentification, les retries (429 / 5xx), le typage et des helpers (findConnected, waitForTerminal). Voir le guide SDK.
Suite
- SDK officiels ou créer une clé API
- Envoyer un premier message ou extraire une URL
- Référence technique — Messages
Spécification machine : openapi.json (section Outils développeur).
Voir aussi
Cet article vous a-t-il aidé ?