API-mocks

API-prototyping

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

Als stakeholders daadwerkelijk interactie kunnen hebben met het API-ontwerp, is de kans groter dat u sneller betere feedback krijgt, aangezien de ervaring van het beoordelen van de API meeslepender en realistischer is.

Parallelle implementatie van frontend en backend

In veel projecten is er, zodra de API-ontwerpfase is voltooid, zowel backendcode die moet worden geschreven om de API te implementeren, als frontendcode die de API zal gebruiken.

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

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

Contentonderhandeling

De enige dynamiek die de mocks bieden, is content negotiation. Als u meerdere bodies 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 verzenden naar de mock-eindpunt-URL die wordt weergegeven in API Contracts.