api-reference

1. Crea un token API o una clave de sitio web

Crea un token API de workspace desde la página API Tokens cuando necesites acceso programático a todos los sitios web del workspace, incluidas integraciones MCP y OpenClaw. Los tokens de workspace usan el prefijo <code>flow_ws_</code>. Para tracking servidor a servidor de un solo sitio, crea una clave API de sitio web desde Settings > API de ese sitio; las claves de sitio usan el prefijo <code>flow_</code>. Copia los tokens nuevos de inmediato porque el secreto solo se muestra una vez.

2. Autenticar sus solicitudes

Cada llamada API debe incluir el encabezado Authorization con el esquema Bearer. Usa un token de workspace <code>flow_ws_</code> para acceso API multi-sitio, o una clave de sitio web <code>flow_</code> para un solo sitio.

Encabezado de autorizacion
Authorization: Bearer YOUR_API_KEY

3. Comenzar a hacer solicitudes

La URL base para todos los endpoints v1 es: <code>https://analytics.flowsery.com/api/v1/</code>. Con un token de workspace, llama primero a <code>GET /websites</code> y luego pasa <code>websiteId</code> o <code>domain</code> en las solicitudes. Las claves de sitio web ya están limitadas a un sitio y no necesitan selector.

Formato de respuesta

Las respuestas exitosas devuelven un estado 200 OK con un cuerpo estructurado asi:

Respuesta exitosa
{
  "status": "success",
  "data": { ... }
}

Los errores utilizan la forma de respuesta de error HTTP normal de NestJS.

Respuesta de error
{
  "message": "Unauthorized",
  "statusCode": 401
}

Codigos de error estandar

<strong>400 Bad Request</strong> -- La entrada no es válida o faltan parámetros requeridos.<br /><strong>401 Unauthorized</strong> -- Falta el token API, no es válido, expiró o no se acepta para este endpoint.<br /><strong>404 Not Found</strong> -- El recurso solicitado no existe.<br /><strong>500 Internal Server Error</strong> -- Se produjo un problema inesperado en el servidor.
Solicitud de ejemplo (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"
    }
  ]
}