Varför API-versionsstrategi är viktig

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

Introduktion till API-versionshantering

Introduktion till versionshantering

Azure API Management

Grunderna i API-versionshantering

Versionshantering som analogi

  • Används när brytande ändringar skulle förvirra användarna

  • Medan den nya linjen byggs fortsätter passagerare använda den gamla

  • Revisioner liknar underhåll på samma linje

    • Laga spår, förbättra skyltar, jämna ut resan

  • I APIM:

    • Versioner finns i en versionsuppsättning
    • Revisioner låter dig redigera, testa och markera en som aktuell
Azure API Management

Versionsmärkning

  • Tre strategier för versionsmärkning stöds:
    • Versionen kan anges i URL-sökvägen
    • Versionen kan anges i begärandets huvud
    • Versionen kan anges i URL:ens frågesträng
  • Versionstrategin måste vara konsekvent

Versionshantering via URL-sökväg

Versionshantering via huvud

Versionshantering via frågesträng

Azure API Management

Version kontra revision

Version kontra revision

Azure API Management

Canary-releaser

Canary-release

  • Utfall:
    • Positivt utfall -> markera revisionen som aktuell
    • Negativt -> återgå till föregående revision

  • Som ett kökstest: servera ett nytt recept till några bord först

  • I APIM:

    • Skapa en ny revision och testa den internt
    • Exponera den för en begränsad målgrupp (pilotprodukt eller delmängd av anropare)
    • Nå en specifik revision via en särskild URL med revisionsnumret

  • Järnvägsmetafor: testare åker på "underhållsspåret" utan att påverka huvudlinjen

Azure API Management

Viktiga begrepp att komma ihåg

  • När du ska använda versioner respektive revisioner
  • Konfigurera versionsschema
  • Rulla ändringar framåt och bakåt

API Management

Azure API Management

Nu kör vi en övning!

Azure API Management

Preparing Video For Download...