api-reference

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-tête Authorization utilisant le schéma Bearer. Les clés API doivent commencer par le préfixe flow_.

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 erreurs utilisent la forme normale de réponse d'erreur HTTP NestJS.

Reponse d'erreur
{
  "message": "Unauthorized",
  "statusCode": 401
}

Codes d'erreur standards

<strong>400 Bad Request</strong> -- L'entrée n'est pas valide ou les paramètres requis sont manquants.<br /><strong>401 Non autorisé</strong> -- La clé API est manquante, non valide ou ne commence pas par flow_.<br /><strong>404 Not Found</strong> -- La ressource demandée n'existe pas.<br /><strong>500 Erreur interne du serveur</strong> -- Un problème inattendu s'est produit sur le serveur.
Exemple de requete (curl)
curl --request GET \
  --url https://analytics.flowsery.com/api/v1/overview \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "visitors": 12450,
      "sessions": 16890
    }
  ]
}