apidays LIVE LONDON - The Road to Embedded Finance, Banking and Insurance with APIs OpenAPI-driven API development lifecycle at Adyen Aleksei Akimov, Head of APIs at Adyen

1. OpenAPI-driven API
development lifecycle
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 design
Technical documentation
Developer relations
Dev tooling
Developer Experience 🧡

3. About Adyen

4. "Adyen's omnichannel payments processing
product and global acquiring footprint mean
that merchants can avoid the operational
headaches that a multi-back-end architecture
creates, it does so without losing its tech focus,
leveraging its data and machine learning to
effectively boost authorization rates.
“Adyen has exploded along with its
customers, startup Internet giants
including Facebook, Uber and Spotify.”
“Adyen has carved out a powerful place by
laying down smooth payment rails all over the
world for the biggest names in tech.”
WAVE
LEADER 2016
WAVE
LEADER 2018
WAVE
LEADER 2020

5. xw

6. Point of Sale & eCommerce
eCommerce
Local acquiring on a global scale

7. Scalable
architecture
exponential growth
• Single code base
• Distributed stateless architecture

8. Adyen API landscape
• 20+ web APIs
• 100+ different
versions
• 150+ endpoints

9. Challenges
* Reliability
* Performance
* Scalability
* Security
* Interoperability
* Consistency
* Evolution
* Developer experience

10. Using standards gives you a competitive
advantage in scaling up your technology.
And OpenAPI is one of the most valuable
ones in the API space at the moment.

11. About OpenAPI

12. What is OpenAPI?
OpenAPI (formerly known as Swagger) – standard format
to describe Web APIs (HTTP APIs). Both human-readable and machine-readable.
• Endpoints
• HTTP verbs (e.g. GET /users, POST /users)
• Parameters for each operation
• Request and response models
• Authentication
• Contact information, license, terms of use, etc.

13. JSON YAML

14. Why OpenAPI?
• Supported by Linux foundation (OpenAPI Initiative)
• Exists from 2010
• Open-source project, steadily evolves - 3.0.0 in 2017,
3.0.3 in 2019, 3.1.0RC now
• RAML (Mulesoft) and API Blueprint (Apiary) joined
OAI in 2017, Postman joined in 2020

15. OpenAPI Initiative

16. Use cases

17. OpenAPI use cases
• Documentation (reference + examples)

18. API Explorer

19. “...both human-readable and
machine-readable..”

20. OpenAPI use cases
• Documentation (reference + examples)
• Libraries

21. Adyen libraries

22. OpenAPI use cases
• Documentation (reference + examples)
• Libraries
• Open-sourced API contract

23. GitHub
https://github.com/Adyen/adyen-openapi

24. OpenAPI use cases
• Documentation (reference + examples)
• Libraries
• Open-sourced API contract
• API Tooling (like Postman)

25. Postman

26. Postman

27. OpenAPI use cases
• Documentation (reference + examples)
• Libraries
• Open-sourced API contract
• API Tooling to learn your API (like Postman)
• API Design (Stoplight and SwaggerHub)

28. Stoplight

29. Stoplight

30. OpenAPI use cases
• Documentation (reference + examples)
• Libraries
• Open-sourced API contract
• API Tooling to learn your API (like Postman)
• API Design (Stoplight and SwaggerHub)
• API Style guide linting (via Spectral)

31. Linting

32. OpenAPI use cases
• Documentation (reference + examples)
• Libraries
• Open-sourced API contract
• API Tooling to learn your API (like Postman)
• API Design (Stoplight and SwaggerHub)
• API Style guide linting (via Spectral)
• Server mocks - separate front-end and backend development

33. OpenAPI use cases
• Documentation (reference + examples)
• Libraries
• Open-sourced API contract
• API Tooling to learn your API (like Postman)
• API Design and prototyping (Stoplight and SwaggerHub)
• API Style guide linting (via Spectral)
• Server mocks - separate front-end and backend development
• API monitoring and landscaping

34. Bonus: API evolution information
"recurringDetailReference" : {
"deprecated" : true,
"x-deprecatedInVersion" : 49,
"x-deprecatedMessage" : "Use `storedPaymentMethodId` instead.",
"description" : "This is the `recurringDetailReference`",
"type" : "string"
},

35. API lifecycle development phases
• Design
• Development
• Testing
• Documenting
• Publishing
• Monitoring
• Evolving

36. Takeaways

37. Not only for Docs

38. Not only for REST

39. Not only for "Open" APIs

40. Can bring value on any stage of your
API development lifecycle

42. Deserves to become a standard way
of exchanging API contracts in the
FinTech industry

43. Thank you! https://www.linkedin.com/in/alex-akimov/
https://twitter.com/AlexeyAkimov