api-reference

1. Créer un jeton API ou une clé de site

Créez un jeton API workspace depuis la page API Tokens lorsque vous avez besoin d’un accès programmatique à tous les sites du workspace, y compris les intégrations MCP et OpenClaw. Les jetons workspace utilisent le préfixe <code>flow_ws_</code>. Pour le tracking serveur à serveur d’un seul site, créez une clé API de site depuis Settings > API de ce site; les clés de site utilisent le préfixe <code>flow_</code>. Copiez les nouveaux jetons immédiatement, car le secret n’est affiché qu’une seule fois.

2. Authentifier vos requetes

Chaque appel API doit inclure l’en-tête Authorization avec le schéma Bearer. Utilisez un jeton workspace <code>flow_ws_</code> pour l’accès API multi-site, ou une clé de site <code>flow_</code> pour un seul site.

En-tete d'autorisation
Authorization: Bearer YOUR_API_KEY

3. Commencer a envoyer des requetes

L’URL de base pour tous les endpoints v1 est : <code>https://analytics.flowsery.com/api/v1/</code>. Avec un jeton workspace, appelez d’abord <code>GET /websites</code>, puis transmettez <code>websiteId</code> ou <code>domain</code> aux requêtes. Les clés de site sont déjà limitées à un site et ne nécessitent pas de sélecteur.

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 est invalide ou des paramètres requis manquent.<br /><strong>401 Unauthorized</strong> -- Le jeton API est manquant, invalide, expiré ou non accepté pour cet endpoint.<br /><strong>404 Not Found</strong> -- La ressource demandée n’existe pas.<br /><strong>500 Internal Server Error</strong> -- Un problème inattendu s’est produit sur le serveur.
Exemple de requete (curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/websites \
  --header 'Authorization: Bearer <workspace-api-token>'
200
{
  "status": "success",
  "data": [
    {
      "id": "cm8abc123",
      "domain": "example.com",
      "timezone": "America/New_York",
      "currency": "USD",
      "trackingId": "flid_abc123"
    }
  ]
}