WSO2Con2024 - From Blueprint to Brilliance: WSO2's Guide to API-First Engineering Excellence

WSO2Con2024 - From Blueprint to Brilliance: WSO2's Guide to API-First Engineering Excellence

1. From Blueprint to Brilliance
WSO2’s Guide to API-First
Engineering Excellence
Tishan Dahanayakage
Associate Director/Software Architect
WSO2

2. What is API-First Engineering?

3. Strategic approach that centers on the API,
treating APIs as first-class products which are
designed, implemented, distributed, and maintained
by developers for developers
such a way so that API customers (developers) can build software applications,
services and wider IT systems by “calling” those APIs

- Bernadette Nixon, Forbes Council, CEO @ Algolia -
- Tanya Vlahovic, ex-eBay, Head of Engineering @ Intuit -


Definition
3

4. How !(to do) API-First Engineering?

5. 5

6. How to do API-First Engineering?

7. 7
Design API as a Product

●Improve product market fit
●Treat as primary user
interface
●Maintainability
●Debuggability

8. 8
Adhere to Foundational Design

●Implementation independent
●Holistic API-centric
architecture
○Domain Driven Design
○Cell based architecture
●Reusability

9. 9
Maintain Consistency
●Standards and patterns
○Industry standards
○Domain standards
●Same taxonomy and vocabulary

10. 10
Compose Descriptive and Reliable Documentation
●Descriptive API specification
●Standards and patterns
●Purpose driven docs
○Guides
○Demos & examples
○Solutions

11. 11
Improve Discoverability
●Marketplace
○Searchability
○Metadata and tags
●Ease of use

12. Why API-First Engineering?

13. Improved Developer
Experience and
Productivity
13

14. Enhanced API Security
14

15. Better Compliance and
Governance
15

16. What Choreo Brings to the Table?

17. 17

18. 18

19. 19

20. 20

21. 21

22. Any fool can write code that a
computer can understand. Good
programmers write code that humans
can understand
- Martin Fowler -

23. Question Time!
23

24. Thank You!