Je moet verschillende kleine, niet-brekende updates uitvoeren aan een bestaande API die wordt gehost in APIM. Vereisten: verstoor bestaande aanroepers niet, moet wijzigingen kunnen terugdraaien indien nodig, documentatie leveren voor ontwikkelaars over de wijzigingen, en testen toestaan vóór publicatie. Wat moet je doen?

Het toevoegen van een nieuwe revisie aan de API in Azure API Management (APIM) is de beste oplossing. Revisies stellen je in staat om wijzigingen aan te brengen in een API zonder bestaande aanroepers te verstoren, omdat de oorspronkelijke versie actief blijft. Je kunt de nieuwe revisie testen voordat je deze als de huidige versie instelt, en je kunt gemakkelijk terugdraaien naar een eerdere revisie indien nodig. Bovendien biedt APIM de mogelijkheid om documentatie te genereren voor elke revisie. Header-based en query string-based versioning zijn methoden om verschillende API-versies te beheren, maar revisies zijn specifiek ontworpen voor kleine, niet-brekende updates binnen een bestaande API-versie. Een product is een logische groepering van API's en een custom policy is voor het aanpassen van API-gedrag, niet voor versiebeheer.