Een API publiceren met sleutels

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 ＋ naast Algemeen en kies Nieuwe API. Een API is een basispad met één beveiligingsbeleid; alle endpoints komen eronder en erven dat beleid. Standaard vraagt hij een API-sleutel.

Een endpoint koppelt één methode en pad aan één workflow. Vraag hier een extra recht (scope): alleen sleutels met dat recht komen erdoor. Met ＋ Nieuwe workflow maakt Flow de workflow erachter meteen aan en opent hem.

De nieuwe workflow loopt van de trigger naar API-antwoord. Klik op API-antwoord en zet in de body wat de afnemer terugkrijgt. Hier is dat vast; in het echt komt het uit een tabel of een ander systeem.

Onder Beveiliging → API-sleutels geeft u een afnemer een sleutel. Hij hoort bij een afdeling, opent alleen de API die u aanvinkt, heeft alleen de rechten die u noemt en verloopt vanzelf.

De sleutel ziet u maar één keer: Flow bewaart alleen een vingerafdruk. Kopieer hem naar de wachtwoordkluis van de afnemer (in deze handleiding afgedekt).

Open het endpoint. Rechts staat Proberen: dat roept de API aan precies zoals een afnemer, met de sleutel in de header X-API-Key. U ziet de statuscode, de tijd en het antwoord.