Flow.Documentatie
ProfessionalAPI's

Een nieuwe versie van een API

5 stappen± 4 minVideoGecontroleerd 22 okt 2026
  1. Stap 1 · Open uw ontwikkelomgeving
  2. Stap 2 · Maak versie v2 naast v1
  3. Stap 3 · Hergebruik de logica via een voorkant
  4. Stap 4 · Probeer v2
  5. Stap 5 · Zet v1 uit als iedereen over is

Wat afnemers gebruiken, verandert u niet onder hun handen. Een nieuwe versie zet u naast de oude: dezelfde naam, versie v2 en een eigen basispad. Een endpoint van v2 kan de logica van v1 hergebruiken via een voorkant — één workflow hoort bij één endpoint, zodat de beveiliging van het ene nooit via het andere lekt. Zijn alle afnemers over, dan zet u v1 uit.

Bekijk de hele handleiding als video5 stappen in één film
Stap 1 / 5

Open uw ontwikkelomgeving

Klik in de portal bij Omgevingen op Ontwikkeling, en daar op Openen. Flow opent in een nieuw tabblad, en u bent meteen ingelogd.

  1. Klik op Ontwikkeling
Open uw ontwikkelomgeving · Klik op Ontwikkeling
  1. Klik op Openen ↗
Open uw ontwikkelomgeving · Klik op Openen ↗
Stap 2 / 5

Maak versie v2 naast v1

Maak een nieuwe API met dezelfde naam, het basispad met /v2 en bij Versie v2. In de verkenner staan ze naast elkaar; afnemers van v1 merken niets.

  1. Klik op Toevoegen aan Algemeen
Maak versie v2 naast v1 · Klik op Toevoegen aan Algemeen
  1. Klik op Nieuwe API
Maak versie v2 naast v1 · Klik op Nieuwe API
  1. Vul in bij Naam: Tarieven
  2. Vul in bij Basispad: /tarieven/v2
  3. Vul in bij Versie: v2
Maak versie v2 naast v1 · Vul in bij Naam: Tarieven; Vul in bij Basispad: /tarieven/v2; Vul in bij Versie: v2
  1. Klik op API opslaan
Maak versie v2 naast v1 · Klik op API opslaan
Maak versie v2 naast v1 · Tarieven v1 en Tarieven v2 in de verkenner.
Stap 3 / 5

Hergebruik de logica via een voorkant

＋ Endpoint, GET en hetzelfde pad. Kies bij Workflow de workflow van v1: Flow meldt dat die al bij een ander endpoint hoort, en biedt een voorkant aan — een dunne workflow die de logica aanroept. Er wordt niets gekopieerd.

  1. Klik op ＋ Endpoint
Hergebruik de logica via een voorkant · Klik op ＋ Endpoint
  1. Vul in bij Naam: Tarieven opzoeken v2
  2. Kies bij Methode: GET
  3. Vul in bij Pad: /huur
  4. Kies bij Workflow: Tarieven opzoeken · GET /tarieven/v1/huur
Hergebruik de logica via een voorkant · Vul in bij Naam: Tarieven opzoeken v2; Kies bij Methode: GET; Vul in bij Pad: /huur; Kies bij Workflow: Tarieven opzoeken · GET /tarieven/v1/huur
Hergebruik de logica via een voorkant · Deze workflow hoort al bij een ander endpoint.
  1. Klik op Maak een voorkant en gebruik die
Hergebruik de logica via een voorkant · Klik op Maak een voorkant en gebruik die
  1. Klik op Endpoint opslaan
Hergebruik de logica via een voorkant · Klik op Endpoint opslaan
Hergebruik de logica via een voorkant · Het endpoint van v2 voert de voorkant uit, die de logica van v1 aanroept.
Stap 4 / 5

Probeer v2

Onder Proberen roept u v2 aan met een sleutel die beide versies opent. Het antwoord komt uit dezelfde logica als bij v1.

  1. Vul in bij Sleutel of token: ••••••••
Probeer v2 · Vul in bij Sleutel of token: ••••••••
  1. Klik op ▶ Verstuur
Probeer v2 · Klik op ▶ Verstuur
Probeer v2 · 200 van v2.
Probeer v2 · Hetzelfde tarief als in v1.
Stap 5 / 5

Zet v1 uit als iedereen over is

Ziet u in Live verkeer geen aanroepen meer op v1, open dan v1 en zet Ingeschakeld uit. Afnemers die toch nog v1 aanroepen, krijgen 503; v2 werkt gewoon door.

  1. Klik op Tarieven v1
Zet v1 uit als iedereen over is · Klik op Tarieven v1
  1. Klik op Ingeschakeld
Zet v1 uit als iedereen over is · Klik op Ingeschakeld
  1. Klik op API opslaan
Zet v1 uit als iedereen over is · Klik op API opslaan
  1. Klik op het endpoint van v1
Zet v1 uit als iedereen over is · Klik op het endpoint van v1
  1. Vul in bij Sleutel of token: ••••••••
Zet v1 uit als iedereen over is · Vul in bij Sleutel of token: ••••••••
  1. Klik op ▶ Verstuur
Zet v1 uit als iedereen over is · Klik op ▶ Verstuur
Zet v1 uit als iedereen over is · 503: v1 staat uit.

Deze handleiding is op 22 okt 2026 stap voor stap uitgevoerd door een geautomatiseerde test op Flow (versie 3e563176).