apidays LIVE Paris - Responding to the New Normal with APIs for Business, People and Society December 8, 9 & 10, 2020 How to build better and consistent APIs at scale Samir Amzani, Director of Engineering API at Adidas

1. HOW TO BUILD
BETTER APIS
AT SCALE

2. Director platform engineering - API
@adidas
Hello!
I am Samir AMZANI
You can contact me at @amzani
/ Linkedin

3. PROBLEMS
•WE NEED TO BUILD APPS FASTER
•WE NEED TO BUILD APPS CHEAPER

4. STANDARIZATION
EFFORTS
GROWING
API CONSUMPTION
INCREASE IN
COMPLEXITY
APIS CHALLENGES

5. HOW TO DO
API MANAGEMENT AT SCALE ?

6. STANDARIZE
1

7. “In a society that tries to standardise thinking,
individuality is not highly prized” Alex Grey
STANDARIZE
for personalisation
1

8. API
API
API STYLE
API IMPLEMENTATION
….
API FIRST
ERROR MANAGEMENT
SECURITY
CONTENT-TYPE
…
CENTRALIZED
DECENTRALIZED

9. RFC 7807 - Problem details for HTTP APIs

11. API
STUBS
API
STUBS
API
STUBS
API
STUBS

12. AUTOMATE
API GOVERNANCE
2

13. “My Job is to make
decisions, your job is to
make them good decisions”

14. API TEAM
ENGINEERING
DOCUMENTATION
STRATEGY
API EVANGELIST
OPS
…
API Platform
(API Gateway,
Portal…)
Client
app
API
Client
app
Client
app
API API
Servic
e
Servic
e
Servic
e
consumers
product teams

16. Design
Develop
Test
Deploy
Publi

17. MACHINE-DRIVEN
GOVERNANCE

18. Spectral / Open Source JSON/YAML Linter
API DESIGN
Manual API design check
OLD WAY NEW WAY
VALIDATE YOUR API CONTRACTS

19. Automatic API Contract Sync
API DESIGN
Manual Sync integration
OLD WAY NEW WAY
PUSH YOUR API CONTRACTS FROM CODE
=API Contract Jenkins Library
+
…

20. Declarative API Publication
API PUBLISH
Manual API Exposure
OLD WAY NEW WAY
EXPOSE AN API

21. Client
app
Client
app
Client
app
INGRESS API
consumers
product teams
API PUBLISH

22. Data plane
product teams
API TEAM
ENGINEERING
DOCUMENTATION
STRATEGY
API EVANGELIST
OPS
…
API Platform
Control plane
Admission
controller
API Mgt as a
service
Support
consumers
API PUBLISH

23. API OPS

24. How to navigate API landscape with autonomy ?
AUTO NAVIGATE
3

26. API DISCOVERY
IS COMPLEX
- We still have ProgrammableWeb and Google
for Public APIs…
- Hard to get all API vendors on the same page!
- Multiple actors / journeys

27. API DISCOVERY
https://superface.ai

28. TAKEAWAYS
AUTO NAVIGATE YOUR LANDSCAPE
BALANCE YOUR STANDARIZATION
AUTOMATE YOUR API GOVERNANCE