INTERFACE, by apidays 2021 - It’s APIs all the way down
June 30, July 1 & 2, 2021
API Design is where culture and tech meet each other
Aleksei Akimov, Head of API at Adyen
DevoxxFR 2024 Reproducible Builds with Apache Maven
INTERFACE, by apidays - API Design is where culture and tech meet each other by Aleksei Akimov, Adyen
1. API design is where
culture and tech meet
each other
Aleksei Akimov
2. About me
Aleksei Akimov
Head of API at Adyen
Amsterdam
https://www.linkedin.com/in/alex-akimov/
https://twitter.com/AlexeyAkimov
API strategy
API governance & design
Technical documentation
Developer relations
Dev tooling
Developer Experience 🧡
9. Dozens of public APIs
Thousands of internal APIs
Technology
Security
Scalability
Availability
...
AdyenAPIlandscape
Web, mobile, terminals/etc
Hundreds of thousands
API calls per minute
Private cloud distributed
across EMEA, NA, APAC
and LATAM
€303.6 BN processed in 2020
exponential growth
Available 24/7
19. We prioritize current merchant
experience over future features
To think like the merchant we go
meet them
We design for 20x
Expose your work early
We are all designers, architects,
coders, testers, security officers
and operations engineers
We all make mistakes, but we seek
help as soon as we find out
You own when, where, and how
your code goes live
Your code should be
understandable at 4am under
stress
We embrace new technology
when it has clear benefits
Our tech stack is open source or
built in-house
20. We prioritize current merchant
experience over future features
To think like the merchant we go
meet them
We design for 20x
Expose your work early
We are all designers, architects,
coders, testers, security officers
and operations engineers
We all make mistakes, but we seek
help as soon as we find out
You own when, where, and how
your code goes live
Your code should be
understandable at 4am under
stress
We embrace new technology
when it has clear benefits
Our tech stack is open source or
built in-house
21. API decisions are complex and
impactful:
- require diverse knowledge
- should be made fast
- definition of done
22. Your {public} API is "done" when...
it is used in production {by merchants}
24. API Review Group / API Board
API Design API Reviews
API ideation and feedback,
before development.
Evaluate the use of existing
APIs and come up with
improvements
Style guide & tools
Create a style guide and drive
API tool adoption.
30. Value of good tooling
If you want developers to use your
frameworks in a certain way, you must
invest your time in making it easier for
them
31. API
design
API
consumers
Collaboration is a key:
Stoplight
OpenAPI
API-design first or API-
design-ASAP
Always be in between
Educate, measure, listen to
feedback, improve
Developer Advocacy is a key
API
development
Evaluate the entire A-Z API
lifecycle
Automate/support all the
steps
Remove bottlenecks
Enforce the style guide with
linting