1. Maak een API-token of websitesleutel aan
Maak een werkruimte-API-token aan op de pagina API-tokens als je programmatische toegang nodig hebt tot elke website in je werkruimte, ook voor MCP- en OpenClaw-integraties. Werkruimtetokens beginnen met flow_ws_. Voor server-naar-servertracking van één website maak je een website-API-sleutel aan op de pagina Instellingen > API van die website; websitesleutels beginnen met flow_. Kopieer nieuwe tokens meteen, want het geheim wordt maar één keer getoond.
2. Authenticeer je verzoeken
Elke API-aanroep moet de Authorization-header met het Bearer-schema bevatten. Gebruik een flow_ws_-werkruimtetoken voor API-toegang tot meerdere websites, of een flow_-websitesleutel voor één website.
Authorization: Bearer YOUR_API_KEY3. Begin met verzoeken sturen
De basis-URL voor alle v1-endpoints is: https://analytics.flowsery.com/analytics/api/v1/. Roep met een werkruimtetoken eerst GET /websites aan en geef daarna websiteId of domain mee aan je verzoeken. Websitesleutels horen al bij één website en hebben geen selector nodig.
Kies een werkruimte
Elke aanroep draait in één werkruimte. Zonder de optionele header X-Workspace-Id komt hij in je standaardwerkruimte terecht. Een OAuth-login, zoals de connector voor Claude of ChatGPT, kan bij elke werkruimte waar het lid toe behoort, over organisaties heen: roep GET /workspaces aan om ze te tonen en stuur het gewenste id mee in X-Workspace-Id bij elk verzoek. Een API-sleutel hoort bij één werkruimte, dus stuur het eigen id mee of laat de header weg.
X-Workspace-Id: cm8ws1a2b3Een werkruimte waar de aanroeper niet bij kan, antwoordt met 403 Forbidden en de code workspace_access_denied. Een API-sleutel of websitesleutel met het id van een andere werkruimte krijgt dezelfde fout.
{
"statusCode": 403,
"error": "Forbidden",
"code": "workspace_access_denied",
"workspaceId": "cm8ws4c5d6",
"message": "Je hebt geen toegang tot werkruimte cm8ws4c5d6. Roep GET /workspaces aan om de werkruimtes te zien die je kunt gebruiken, en stuur een van die id's mee in de X-Workspace-Id-header."
}Antwoordformaat
Geslaagde antwoorden geven status 200 OK terug met een body in deze vorm:
{
"status": "success",
"data": { ... }
}Fouten gebruiken de gewone vorm van een NestJS-HTTP-foutantwoord.
{
"message": "Unauthorized",
"statusCode": 401
}Standaardfoutcodes
<strong>400 Bad Request</strong> -- De invoer is ongeldig of verplichte parameters ontbreken, zoals een werkruimtetoken zonderwebsiteId of domain. Een websitesleutel die GET /workspaces aanroept, krijgt ook 400.<br /><strong>401 Unauthorized</strong> -- Het API-token ontbreekt, is ongeldig of ingetrokken. De code token_issuer_lost_access betekent dat het lid dat de sleutel aanmaakte geen toegang meer heeft tot de werkruimte; maak een nieuwe sleutel aan.<br /><strong>403 Forbidden</strong> -- workspace_access_denied: de X-Workspace-Id-header noemt een werkruimte waar deze sleutel niet bij kan. subscription_required: het abonnement bevat geen API-toegang meer. permission_denied: je rol in de werkruimte mist de permissie flowsery.write, die Admins en Editors hebben. Tijdens een gratis proefperiode antwoorden door AI gevonden problemen na de eerste 10 met "Upgrade to view this issue".<br /><strong>404 Not Found</strong> -- De gevraagde resource bestaat niet.<br /><strong>429 Too Many Requests</strong> -- Meer dan 600 verzoeken in een minuut voor deze sleutel. Wacht het aantal seconden uit Retry-After. Elk antwoord bevat RateLimit-Policy, RateLimit-Limit, RateLimit-Remaining en RateLimit-Reset.<br /><strong>500 Internal Server Error</strong> -- Er is een onverwacht probleem op de server opgetreden.curl --request GET \
--url https://analytics.flowsery.com/analytics/api/v1/websites \
--header 'Authorization: Bearer <workspace-api-token>'{
"status": "success",
"data": [
{
"id": "cm8abc123",
"domain": "example.com",
"timezone": "America/New_York",
"currency": "USD",
"trackingId": "flid_abc123"
}
]
}