# Je eerste stappen

Met vlows beheer je de toegang tot je API-koppelingen en zie je hoe die worden gebruikt. Je logt in op de console en maakt daar een key. Je koppeling gebruikt die key voor aanvragen aan `https://api.vlows.io`. In de console vind je **API-keys**, **API-gebruik** en je opgeslagen **Bedrijfsprofiel**.

## 1. Maak een gratis testaccount

Open [de portal](https://portal.vlows.io/signup). De nieuwe registratie is nadrukkelijk **CONCEPT · DUMMY**: fictieve leveranciersgegevens en voorlopige juridische teksten. Gebruik fictieve bedrijfsgegevens en je eigen testmailadres. Vul eerst alleen e-mail en wachtwoord (15–128 tekens) in.

Bevestig je e-mail, vul daarna het Nederlandse of andere EU-bedrijfsprofiel in en controleer de conceptafspraken. Bekijk [alle velden en stappen](/account/). Er ontstaat geen betaald abonnement.

## 2. Stel als laatste 2FA in

Scan de QR-code met je authenticator, bevestig de code en bewaar de tien herstelcodes. Kies **Registratie afronden**. De volgende keer log je in met eerst je wachtwoord en daarna de aparte 2FA-code. Zie [Tweestapsverificatie](/tweestapsverificatie/).

## 3. Maak een API-key

Open **API-keys** en kies een herkenbare naam, bijvoorbeeld `Testkoppeling gebruik`. Kies type **Systeemkoppeling** en vink alleen **API-gebruik lezen** aan voor je eerste test. Bij nieuwe conceptaccounts is **API-gebruik lezen** de beschikbare optie; toegang tot pakketgegevens is niet geactiveerd.

Klik op **API-key aanmaken** en bewaar de getoonde sleutel. Je krijgt hem maar één keer te zien. In de console is een nieuwe key 90 dagen geldig.

> Een API-key is een toegangssleutel voor software. Deel hem niet in een chat, screenshot of browserpagina. Bewaar hem in de geheime configuratie van je koppeling.

## 4. Doe een testaanvraag

Gebruik de key in een terminal of in je integratie. Het volgende voorbeeld vereist `usage:read`:

```sh
API_URL=https://api.vlows.io
# Stel API_KEY in via je eigen geheime configuratie.
curl --fail-with-body --silent --show-error \
  "$API_URL/account/v1/usage" \
  -H "Authorization: Bearer $API_KEY"
```

Een antwoord met `data` en `error: null` betekent dat de aanvraag is gelukt. `data` kan aanvankelijk een lege lijst zijn. De usage-aanvraag zelf wordt na het ophalen als gebruik geregistreerd.

## 5. Controleer je gebruik

Open **API-gebruik**. Je ziet aanvragen, eenheden, fouten en recente verzoeken. Het scherm ververst elke 60 seconden; je kunt de pagina ook zelf herladen.

Wil je de test afronden? Trek de key in bij **API-keys**. Nieuwe aanvragen met die key geven daarna `401`. De gebruikslogs blijven bewaard. Lees verder bij [API-gebruik begrijpen](/api-gebruik/).