Agile App Development with Azure API Management Darrel Miller, Senior SDE darrmi@microsoft.com Work on the Azure API management team This talk -> using API Management to build Agile Apps To be agile means to embrace incremental change We are going to talk about managing change in HTTP Apis But before we do…

APIs and API economy Mobile Cloud IoT Analytics 2-speed IT Microservices API economy makes APIs a first class concept Not just an implementation detail that only devs care about It is a contract between providers and consumer API maybe just a supporting function Driving mobile app, or 3rd party integration Or actually a product in itself Critical part of the business service

Why use Azure API Management Microsoft Build 2016 11/27/2018 1:41 PM Why use Azure API Management AZURE API MANAGEMENT Abstract decouple optimize evolve package Govern secure protect cache transform Monitor observe report analyze monetize On-board discover learn interact join So how can Azure API management help… … Now you have and idea what it can do, let’s look at architecture APIs on Azure APIs outside Azure 3rd party APIs Azure APIs © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Developed using any technology Microsoft Build 2016 11/27/2018 1:41 PM AZURE API MANAGEMENT Admin portal Gateway Developer Portal APP DEVELOPERS DIRECT VPN ExpressRoute BACKEND APIs APPS Three components: dev portal, gateway, admin portal … Backend hosted anywhere on any platform, As long as it is a HTTP API Hosted anywhere Developed using any technology API MANAGERS © 2016 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

HTTP APIs are different Language / Runtime APIs HTTP APIs Compilers/Runtimes define breaking change Consumer code defines breaking changes HTTP APIs are different … In order to clear make this distinction, Introduce new language Consumers choose when to update Provider decides if consumer can choose

Categorizing Change Versions Revisions Consumers choose when to adopt Terms usually used interchangeably … Alternative to the semantic versioning model, because breaking changes can’t be defined. Revisions need to meet an API Providers “Change Level Agreement” Consumers choose when to adopt Providers choose when to deploy

Managing API Change Advertise Change Hide Change API Contract So, how can API Mgmt help us deal with versions and revisions Developer portal is a customizable web site that provides tools and documentation to learn about API Used to advertise new versions API Contract is the interface. It’s the WHAT is changing. Changes in contract may be versions or revisions, depends on CLA Gateway acts as a façade to the API implementation isolate the backend Where revisions hide Let’s look into these three aspects a little bit more and then we will see how the product enables it Developer Portal Gateway Façade

Advertise Change Developer Portal Sign Up Sign In Discover Try Build Developer portal is about facilitating on-boarding API community has recognized this as critical to adoption Change is irrelevant if no-one is using your API Self-service sign-on support for many IdPs Monitor for reliability and performance Review reports for usage Knowing what to change is as important as how Build Monitor Report

API Contract API Description formats define an interface. WSDL came first for SOAP -> protocol independent API WADL is XML based from the Java world OpenAPI (fka Swagger) JSON based, very popular MSFT using it in many products. Handle both revisions and versions

Hiding Implementations 3rd Party There are many ways to implement HTTP APIs Even on Azure there are different services Some fit better for different scenarios An how a feature needs to change can be a determining factor Azure Functions Logic App API Apps

Agile Apps demo With Azure API Management

API Management Versions and Revisions Service Instance API Version Revision Operation ;rev=1 ;rev=2 /v2 ;rev=3 /speakers /sessions /days ;rev=4 https://example.org/ api /v3 ;rev=1 ;rev=2

Alternate Versioning Strategies GET https://conference.com/api/v2/speakers Path GET https://conference.com/api/speakers?version=2 Query GET https://conference.com/api/speakers api-version: v2 Header GET https://conference.com/api/speakers Content-Type: application/vnd.myformat.v2 Media Type

Managing Change with API Management OpenAPI Contract Developer portal for advertising change Gateway façade for hiding changes Versions and Revisions for temporal control

7.7K 29K 20B 250M 27 May 2014 Customers Total APIs Build 2015 11/27/2018 1:41 PM 7.7K Customers 21% of Fortune 100 Banking, insurance, energy, retail, transportation, manufacturing… 29K Total APIs 20B Total calls per month 250M Calls per day by the top customer 27 Regions in 14 geos May 2014 Launched on Azure © 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

http://aka.ms/apimroadmap

11/27/2018 1:41 PM © Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.