De beschrijving van een API: OpenAPI en WSDL
Flow beschrijft elke API zelf, uit wat u bouwt: een OpenAPI-beschrijving voor REST en een WSDL voor endpoints die ook SOAP spreken. Standaard leest alleen wie een sleutel of token voor die API heeft de beschrijving. Met Openbare documentatie kan iedereen hem lezen — ontwikkelaars van partners bouwen ertegen zonder account — terwijl aanroepen nog steeds aanmelden vraagt.
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.
- Klik op Ontwikkeling
- Klik op Openen ↗
Zet SOAP en openbare documentatie aan
Open de API. Onder Protocollen en beveiliging vinkt u SOAP aan als afnemers ook SOAP gebruiken, en Beschrijving openbaar om de beschrijving voor iedereen leesbaar te maken. Aanroepen blijft aanmelden vragen.
- Klik op de API
- Klik op SOAP
- Klik op Beschrijving openbaar
- Klik op API opslaan
Lees de OpenAPI-beschrijving
De link OpenAPI van deze API opent de beschrijving in een nieuw tabblad, zonder aan te melden: paden, methoden, het aanvraagschema met verplichte velden, de antwoorden en hoe u zich aanmeldt.
- Klik op OpenAPI van deze API ↗
Laat het endpoint ook SOAP spreken
Open het endpoint en vink SOAP aan. De SOAP-operatie krijgt een naam uit de naam van het endpoint; u kunt hem overschrijven. Na opslaan staat naast het adres een link naar de WSDL.
- Klik op het endpoint
- Klik op SOAP
- Klik op Endpoint opslaan
Deze handleiding is op 22 okt 2026 stap voor stap uitgevoerd door een geautomatiseerde test op Flow (versie 3e563176).