API-mocks

API-prototyping

De eerste use case voor API-mocks is API-prototyping. Het idee hierbij is dat zodra u een iteratie van uw API-ontwerp hebt voltooid, u feedback wilt krijgen van verschillende belanghebbenden in het API-project: teamleden, ontwikkelaars die de API gaan gebruiken, producteigenaren, enz.

Als belanghebbenden daadwerkelijk kunnen communiceren met het API-ontwerp, is de kans groter dat u betere en snellere feedback krijgt, omdat de ervaring van het beoordelen van de API meeslepender en realistischer is.

Parallelle front-end- en back-end-implementatie

In veel projecten moet er, zodra de ontwerpfase van de API is voltooid, zowel back-end-code worden geschreven om de API te implementeren, als front-end-code die de API gaat gebruiken.

Zodra het API-contract is vastgesteld, is er geen echte reden voor de front-end-ontwikkelaars om te wachten tot de back-end-ontwikkelaars klaar zijn voordat ze beginnen. Op een dergelijke lineaire manier te werk gaan, zal de time-to-market vergroten en de feedbackcycli tussen back-end- en front-end-teams tijdens de ontwikkeling vertragen.

Het hebben van een API-mock die up-to-date is met het nieuwste API-contractontwerp stelt front-end- en back-end-teams in staat om parallel te werken.

Content negotiation

De enige dynamiek die door de mocks wordt geboden, is content negotiation. Als u meerdere body's in de API hebt gedefinieerd en u een verzoek doet met een compatibel mediatype in uw Accept-header, gebruikt de mock deze body om de respons te maken.

Een mock testen

U kunt uw mock testen met elke API-client, zoals API Tester, Postman of cURL, door verzoeken te sturen naar de mock-eindpunt-URL die wordt weergegeven in API Designer.