Navigating the Post-OpenAPI Era with Innovative Design Frameworks 2

3 Who I am Daniel Kocot Head of API Consulting @codecentric [email protected] www.linkedin.com/in/danielkocot

4 Agenda The Shift Beyond OpenAPI The API Value Proposition Canvas Challenges of OpenAPI and the Need for Innovation Role of API Development TypeSpec

5 Agenda The Shift Beyond OpenAPI The API Value Proposition Canvas Challenges of OpenAPI and the Need for Innovation Role of API Development TypeSpec

6 Flexibility in API Design The Shift Beyond OpenAPI

7 Flexibility in API Design Declarative and Modular API Descriptions The Shift Beyond OpenAPI

8 Flexibility in API Design Declarative and Modular API Descriptions Developer-Centri c Tools The Shift Beyond OpenAPI

9 Agenda The Shift Beyond OpenAPI The API Value Proposition Canvas Challenges of OpenAPI and the Need for Innovation Role of API Development TypeSpec

10 How do we ensure that the APIs we build are truly aligned with the business goals while keeping developer efficiency at the core?

API Value Proposition Canvas 11

What? 12

13 APIs must solve business problems, enable new revenue streams, or support core operations. Developer Perspective Business Perspective APIs must be easy to understand, implement, and maintain while providing flexibility to adapt to different interaction patterns and technical requirements. API Value Proposition Canvas (AVPC) is a tool that helps mapping the needs of API consumers against the value an API provides. It ensures that every API delivers tangible business and user benefits while keeping the developer pain points in check.

API Value Proposition Canvas 14

15 Agenda The Shift Beyond OpenAPI The API Value Proposition Canvas Challenges of OpenAPI and the Need for Innovation Role of API Development TypeSpec

16 Key Challenges Focus on REST

17 Key Challenges Focus on REST Expressiveness and Verbosity

18 Key Challenges Focus on REST Expressiveness and Verbosity Limited Collaboration and Design-First Flexibility

19 Key Challenges Focus on REST Expressiveness and Verbosity Limited Collaboration and Design-First Flexibility Client Generation and Documentation Pitfalls

Resource / Hypermedia 20 Tunnel Query Event- Based

HTTP / REST 21 gRPC GraphQL Kafka

22 Agenda The Shift Beyond OpenAPI The API Value Proposition Canvas Challenges of OpenAPI and the Need for Innovation Role of API Development TypeSpec

23 API development is more than just writing code or documenting endpoints. It's about solving real-world business problems through well-designed, scalable, and maintainable interfaces that create value.

24 Traditionally, API Developer are people who write technical specifications and provide the glue between systems. The New Reality Key Concept 1: API Development as Problem Solver The Old View - Understanding the bigger picture. - Alignment of business goals - Beyond simply exposing data

25 Create interfaces for systems without much input from other teams. The New Reality Key Concept 2: API Development’s Role Collaboration The Old View - Working closely with stakeholders - Understanding the needs of API consumers

26 Handle the complexities of API documentation, versioning, and change management manually The New Reality Key Concept 3: Efficiency and The Right Tools The Old View - Focus on Efficiency - Automate repetitive tasks - Ensure consistency - Simplify version management

27 Agenda The Shift Beyond OpenAPI The API Value Proposition Canvas Challenges of OpenAPI and the Need for Innovation Role of an API Developer TypeSpec

28 We've all used OpenAPI, a reliable standard for API design. But as our needs evolve, so do our tools. Microsoft TypeSpec steps in—not to replace standards, but to extend and enhance them.

29 Building on Standards’ Foundation Modular and Extensible API Design Developer-centri c Design Process Main Points

From AVPC to API Design with Typespec 30

31 Define the core business objectives using the canvas. What value is the API supposed to deliver? Step 1 From Canvas to Design

32 Define the core business objectives using the canvas. What value is the API supposed to deliver? Translate these insights into concrete API design elements. Focus on the aligning the API structure with business needs. Step 1 Step 2 From Canvas to Design

33 Define the core business objectives using the canvas. What value is the API supposed to deliver? Translate these insights into concrete API design elements. Focus on the aligning the API structure with business needs. Use TypeSpec to generate the appropriate interaction patterns based on the design. Step 1 Step 2 Step 3 From Canvas to Design

34 APIs designed using TypeSpec deliver measurable value - faster time to market, easier maintenance, and adaptability to future needs Developer Outcome Value for Both Sides Business Outcome Developers save time, reduce cognitive load, and focus on crafting APIs that solve business problems instead of managing technical debt or repetitive tasks.

API Design in the Post-OpenAPI Era 35

36 Efficiency Through Simplification Flexibility in API Interaction Patterns Sustainable Evolution and Collaboration 3 Key Principles

37 Post-OpenAPI Era ● Efficiency First ● Business meets Development ● Not every API needs to be REST "TypeSpec is the tool that brings developer efficiency and business value together." Daniel Kocot Head of API Consulting [email protected] https:/ /www.linkedin.com/in/danielkocot Daniel (he / him)

codecentric AG | Hochstraße 11 | 42697 Solingen Creating the digital future together. 39 codecentric AG | Hochstraße 11 | 42697 Solingen Creating the digital future together.