Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance...
Transcript of Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance...
![Page 1: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/1.jpg)
Scott CrantonDirector, Application Platform SAsApril 2018
Transforming the Internal IT Landscape with APIs
![Page 2: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/2.jpg)
2
AGENDA
● API Domain Overview● (very) Brief Technical Overview● How to help your API Program Succeed
![Page 3: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/3.jpg)
3
COMMON CHALLENGES INMODERN APPLICATION DEVELOPMENT
Integrate SaaS Apps
Extend Legacy Apps
Customer and Partner Access
IoT Devices and Architectures
Enable Customer Facing Apps via Many Channels
Data Access for Business Users
Building Scalable Cloud Native Applications
![Page 4: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/4.jpg)
3scale API Management4
![Page 5: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/5.jpg)
What do APIs Really Do?
Provide Stable, Reusable Interfaces
5
![Page 6: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/6.jpg)
6
MOST COMMON API USE-CASES
Mobile & IOT Support
Customer Integration
Partner Ecosystem
Internal Agility
APIs as a Business
Content & Transaction
Channel
![Page 7: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/7.jpg)
Lines between Internal and External APIs are Blurring
7
![Page 8: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/8.jpg)
8
CAMPBELL'S SOUP: APIs LEAD TO A BREAKTHROUGH NEW CUSTOMER CHANNEL
● Initially created a Nutrition and Recipes API to be used by marketing agencies and application designers
● Reaching new audiences with the recipe application “Campbell's Kitchen” on the Amazon Echo device
● Very high value brand interaction in the customers’ residences
● Leading to possible Integration with Amazon shopping cart to provision for recipes
![Page 9: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/9.jpg)
9
INTEGRATION AND APIs DRIVE AIR TRAVEL INNOVATION
● Schiphol Airport aims for world class traveller experiences
● Using Integration to create the right API endpoints and then putting them in the hands of partners creates an extended team to deliver innovation
● Flight, baggage, reservation, and other data are available throughout the airport and to all partners
● APIs through API Management provide the foundation for seamless handoff between the airport and its partners
![Page 10: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/10.jpg)
10
QANTAS - DRIVING ORGANIZATIONAL CHANGE THROUGH APIS
● Promoted a change to API First 2-3 years ago to identify key resources and make them more reusable
● Internal APIs are changing development patterns inside large organizations
● Stable APIs are creating new opportunities to innovate for internal developers and outsourced teams
● Powering mobile applications, integrations and (shortly) partners
![Page 11: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/11.jpg)
11
● APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes
○ Correlated to higher performing organizations● Inverse Conway Maneuver - teams and org structure evolve to attain desired
architecture● Benefits derived when teams can make large design changes with little to no
communication with other teams
● Critical that APIs are stable, well documented, and managed like a SaaS / Product
APIS HELP PROVIDE LOOSE COUPLINGAccelerate by Forsgren, Humble, & Kim
![Page 12: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/12.jpg)
12
THREE PILLARS FOR AGILE INTEGRATIONKey capabilities for modern software application agility
DISTRIBUTEDINTEGRATION
-LIGHTWEIGHT-PATTERN BASED-EVENT ORIENTED
-COMMUNITY SOURCED
CONTAINERS
- CLOUD NATIVE SOLUTIONS-LEARN ARTIFACTS,
INDIVIDUALLY DEPLOYABLE- CONTAINER BASED SCALING AND HIGH
AVAILABILITY
APIs
-WELL DEFINED, REUSABLE,AND WELL MANAGED
END-POINTS-ECOSYSTEM LEVERAGE
FLEXIBILITY SCALABILITY RE-USABILITY
Tools and Processes
![Page 13: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/13.jpg)
13
API CAPABILITIESAPI Strategy
API Development & Integration
API Management
API Operations
New API Development
Legacy SystemsGatewayDev
PortalAnalytics
Automation Dev Ops Continuous Integration and Delivery
Rate LimitingSecurity \
AuthenticationMicroservicesComposite APIs
![Page 14: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/14.jpg)
14
HIGH LEVEL ARCHITECTURE
Admin Portal
● Dashboard● Developer /
Application / Key Management
● CMS● Analytics● Billing
API Consumers
(App Developers)Authorize & Report Traffic
Developer Apps
Developer Portal
● API Provider Branded ● API Description● Signup● ActiveDocs (OAS)
API BackendAPI Gateway
API Manager
API Provider
(Line Of Business / Product Manager,
Writers, Ops)
API Request Authorized API Request
API Implementor
(Developers, Integrators)
![Page 16: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/16.jpg)
Help Your API Program Succeed
![Page 17: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/17.jpg)
17
API PROGRAM STRATEGIES
1. Focus on the value of the API2. Obsess about developer experience (DX)3. Remember API retirement and change
management
![Page 18: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/18.jpg)
18
THE API OWNER’S MANUAL
● Captured learning from successful API teams
● Reinforced by recent experience
● Digital Copy: https://engage.redhat.com/3scale-api-owners-s-201706160312
![Page 19: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/19.jpg)
19
FOCUS ON THE VALUE OF THE API
Thor Mitchell / Google / Crowdcube
DesirableUndesirable
Expected
Unexpected
Design
Fire Drill Innovation
Prohibited
![Page 20: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/20.jpg)
3scale API Management20
BUSINESS (OR VALUE!) MODEL
● Different types of value (monetary, brand, loyalty) etc. are all valid
● Adoption of an API is often just as expensive as provision
● Think of the Apple Store value creation equation
Operator BenefitUser Benefit
![Page 21: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/21.jpg)
3scale API Management21
OBSESS ABOUT DEVELOPER EXPERIENCE
Time To First Hello World
● Make it very clear what the API does
● Provide instant signup● Provide free access● Be transparent about pricing● Having great documentation● Having the means to test the
API Live
![Page 22: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/22.jpg)
3scale API Management22
RETIREMENT AND CHANGE MANAGEMENT
● Often Forgotten● Just as critical as
launch● Communicate
Roadmaps, Communicate Change
● Provide Migration opportunities
![Page 23: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/23.jpg)
What To Measure
![Page 24: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/24.jpg)
Bad Metrics
Number of APIs Number of API Calls Number of Integrations
Number of Containers Number of Servers
Number of Lunch & Learns
![Page 25: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/25.jpg)
Good Metrics
Number of Apps Supported
Number of complete Use Cases Number of Users
Dollar Value of Business
Speed of Application
development
Speed of API Deployment
![Page 26: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/26.jpg)
Take Aways...
![Page 27: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/27.jpg)
27
● Incremental transformation● Creating a new organizational
capability● Treating APIs as products rather
than resources
![Page 28: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/28.jpg)
28
THANK YOU FOR YOUR TIME!
● APIs will very likely be a key architectural component for most organizations
● Red Hat is investing heavily and aiming to be a long term partner
● Agile Integration, Container Management, and API Management will be a key architectural pillars for the next 3-5 years
![Page 29: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/29.jpg)
29
FOLLOW UP MATERIAL
● Red Hat Integration homepage: https://www.redhat.com/en/technologies/jboss-middleware/integrate
● “Inside mind of a successful platform architect / Gartner APPS 2016” https://www.slideshare.net/3scale/inside-mind-of-a-successful-platform-architect-gartner-apps-2016
● “API Model Canvas for successful API strategies and programs” https://www.slideshare.net/3scale/api-model-canvas-for-successful-api-strategies-and-programs
● “The API Owner’s Manual” https://www.redhat.com/en/resources/3scale-api-owners-manual-ebook
![Page 30: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/30.jpg)
THANK YOUplus.google.com/+RedHat
linkedin.com/company/red-hat
youtube.com/user/RedHatVideos
facebook.com/redhatinc
twitter.com/RedHat
![Page 31: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/31.jpg)
31
2. BUSINESS (OR VALUE!) MODEL
● Don’t leave adoption benefit to chance
● Decide what is in and out of scope for your users
● This is even true inside an organization
1. Create Value
2. Do not attempt to capture all the value you create
![Page 32: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/32.jpg)
3scale API Management32
3. FOCUS ON USERS AND USABILITY
“APIs as Products” is a key meme
Re-check who your Users Really are
Make Sure Genuine Use-Cases are Fulfilled
Evolve Interfaces, Documentation and
experience via feedback
![Page 33: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/33.jpg)
3scale API Management33
3. FOCUS ON USERS AND USABILITY1. Data Format: Support of XML, JSON, proprietary formats, or a combination.
2. Method Structure: Methods can be very generic, returning a broad set of data, or very specific to allow for targeted requests. Methods are also usually called in a certain sequence to achieve certain use cases.
3. Data Model: The underlying data model can be very similar or very different to what is actually exposed via the API. This has an impact on usability, as well as maintainability.
4. Authentication: Different authentication mechanisms have different strengths and weaknesses. The most suitable one depends on the context.
5. Usage Policies: Rights and quotas for developers should be easy to understand and work with.
![Page 34: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/34.jpg)
3scale API Management34
4. TACKLE API OPERATIONS
Platform Enablement
Teams
Empower teams to launch and manage
Provide Governance, Guidance, Support
Access Control, Rate Limits, Analytics, Policies,
Onboarding, Documentation
![Page 35: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/35.jpg)
3scale API Management35
6. GO BEYOND MARKETING 101
● Internal and External APIs need Marketing
● Important to diffuse: ○ What resources are
available○ What use-cases are
intended○ Highlight successful users
● The things to try:○ Puzzles○ SDKs○ Discovery / Registries○ Co-marketing with
partners
![Page 36: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/36.jpg)
•••••
![Page 37: Transforming the Internal IT Landscape with APIs · 11 APIs (and bounded contexts) can enhance architecture capabilities that allow for independent testing and design changes Correlated](https://reader034.fdocuments.net/reader034/viewer/2022042307/5ed3460aa43dd37c615a5bb3/html5/thumbnails/37.jpg)
•
•
•
Administrators
Databases Mobile Apps Bots End Users
Data ScientistsIntegration Specialists End Users
Shared Integration Libraries and Services Catalogs
Governance Development Management
Developers
Enterprise Applications Partner Applications Customer Applications
Workflow Analytics
Data Services
Batch Request-Response Reactive
Business Logic Services
Big Data
On-Premises Cloud Mobile Edge
Data Pipelines Orchestration Events