---
title: "Aan de slag met de Flowsery Analytics API"
description: "Met de Flowsery Analytics API krijg je programmatisch toegang tot analysegegevens van een hele workspace of één website, van aangepaste doelen tot omzetdetails."
url: "https://flowsery.com/nl/docs/api-introduction"
---

> For AI agents: the full index of these docs is at https://flowsery.com/nl/docs/llms.txt. Every docs page is also available as Markdown: append .md to its URL or request it with the header Accept: text/markdown.

api-reference

## 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-header

```
Authorization: Bearer YOUR_API_KEY
```

## 3\. 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.

Werkruimteheader

```
X-Workspace-Id: cm8ws1a2b3
```

Een 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.

Fout bij werkruimtetoegang

```
{
  "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:

Geslaagd antwoord

```
{
  "status": "success",
  "data": { ... }
}
```

Fouten gebruiken de gewone vorm van een NestJS-HTTP-foutantwoord.

Foutantwoord

```
{
  "message": "Unauthorized",
  "statusCode": 401
}
```

Standaardfoutcodes

<strong>400 Bad Request</strong> -- De invoer is ongeldig of verplichte parameters ontbreken, zoals een werkruimtetoken zonder `websiteId` 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.

Voorbeeldverzoek (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"
    }
  ]
}
```
