Je eerste stappen · vlows wiki

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

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:

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.