Référence API

Introduction à l'API

Premiers pas avec l'API Flowsery Analytics

1. Creer une cle API

Accedez aux Parametres de votre site > onglet API dans le tableau de bord Flowsery Analytics. Generez une nouvelle cle API. Copiez-la immediatement car elle ne sera plus affichee. Traitez vos cles API comme des mots de passe -- stockez-les en securite et ne les exposez jamais dans du code cote client ou des depots publics. Toutes les cles utilisent le prefixe <code>flow_</code> (par ex. <code>flow_sk_live_abc123</code>).

2. Authentifier vos requetes

Chaque appel API doit inclure l'en-tete <code>Authorization</code> avec le schema Bearer. Remplacez <code>YOUR_API_KEY</code> par la cle que vous avez creee.

En-tete d'autorisation
Authorization: Bearer YOUR_API_KEY

3. Commencer a envoyer des requetes

L'URL de base pour tous les points de terminaison v1 est : <code>https://analytics.flowsery.com/api/v1/</code>

Format de reponse

Les reponses reussies retournent un statut 200 OK avec un corps structure comme suit :

Reponse reussie
{
  "status": "success",
  "data": { ... }
}

Les reponses d'erreur retournent le code de statut HTTP correspondant (4xx ou 5xx) avec un corps comme :

Reponse d'erreur
{
  "status": "error",
  "error": {
    "code": "HTTP_STATUS_CODE",
    "message": "A descriptive error message"
  }
}

Codes d'erreur standards

<strong>400 Bad Request</strong> -- L'entree est invalide ou des parametres requis sont manquants.<br /><strong>401 Unauthorized</strong> -- La cle API est manquante ou invalide.<br /><strong>404 Not Found</strong> -- La ressource demandee n'existe pas.<br /><strong>500 Internal Server Error</strong> -- Un probleme inattendu est survenu sur le serveur.