apidays LIVE London 2021 - API design is where culture and tech meet each other by Aleksei Akimov, Adyen
0 likes137 views
Aleksei Akimov, head of API at Adyen, emphasizes the intersection of culture and technology in API design, highlighting the importance of developer experience, technical governance, and effective communication within teams. The document outlines Adyen's API strategy, which prioritizes current merchant experiences, scalability, and the integration of new technologies. It also discusses the significance of collaboration, automated processes, and the review of existing APIs to enhance their effectiveness and user adoption.
apidays LIVE London 2021 - 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 🧡
- 3. API as a language API API 👩💼 🧑💼
- 5. New York JULY Australia SEPTEMBER Singapore APRIL Helsinki & North MARCH Paris DECEMBER London OCTOBER Jakarta FEBRUARY Hong Kong AUGUST JUNE India MAY Check out our API Conferences here 50+ events since 2012, 14 countries, 2,000+ speakers, 50,000+ attendees, 300k+ online community Want to talk at one of our conferences? Apply to speak here
- 6. Point of Sale & eCommerce eCommerce Local acquiring on a global scale
- 8. xw
- 9. Adyen APIs
- 10. 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
- 12. Payments never sleep: Availability 24/7
- 13. Existing customers & history of decisions
- 18. Embedding API design into the company culture
- 19. Culture is “how we do things here”
- 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. 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
- 22. API decisions are complex and impactful: - require diverse knowledge - should be made fast - definition of done
- 23. Your {public} API is "done" when... it is used in production {by merchants}
- 24. Road to successful API governance
- 25. 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.
- 27. API Review Tool: Stoplight
- 28. API Style guide
- 29. Enforce style guide with linting
- 30. OpenAPI, contract testing and design-first JSON YAML
- 31. Evolution and versioning strategy
- 32. 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
- 33. "Make the right thing to do the easiest thing to do. Rest assured, when given options, software developers and architects in your organization will choose the easiest option every single time." (Matt Stine) "Energy is precious and the human brain is wired to conserve it whenever possible. As a result, we often find ourselves sliding into the most convenient option, not necessarily the best option." (James Clear) "We spend far more time doing what's easy than doing what's right." (Shane Parrish)
- 34. 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
- 35. You never know what's next
- 36. Thank you!
- 37. New York JULY Australia SEPTEMBER Singapore APRIL Helsinki & North MARCH Paris DECEMBER London OCTOBER Jakarta FEBRUARY Hong Kong AUGUST JUNE India MAY Check out our API Conferences here 50+ events since 2012, 14 countries, 2,000+ speakers, 50,000+ attendees, 300k+ online community Want to talk at one of our conferences? Apply to speak here