apidays Paris 2024 - TMForum's AsyncAPIs For a New Era of Event-Driven Architecture, Naresh Jain (Specmatic) and Pierre Gauthier, TM Forum

TMForum's AsyncAPIs For a New Era of Event-Driven Architecture
Naresh Jain, Chief Catalyst at Jio Platforms Limited and Founder & CEO of Specmatic
Pierre Gauthier, Chief API Architect at TM Forum

apidays Paris 2024 - The Future API Stack for Mass Innovation
December 3 - 5, 2024

------

Check out our conferences at https://www.apidays.global/

Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8

Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io

Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/

Transcript

1. TMForum's AsyncAPIs A New Era of Event-Driven Architecture Naresh Jain Pierre Gauthier Founder & CEO, Specmatic Chief API Architect - TM Forum naresh@specmatic.io pgauthier@tmforum.org 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 1
2. Time synchronization across Paris in 1880’s? Mechanical clocks would drift apart … Modern electronic clocks were not invented yet ... 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 2
3. Iconic Popp clock in Paris streets 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 3
4. The Paris Pneumatic Clock Network Distribution Room 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 4
5. TM Forum is a global alliance of telco and tech companies 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 5
6. Open API Manifesto Working together to drive interoperability across digital ecosystems with TM Forum’s Open APIs 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 6
7. 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 7
8. 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 8
9. Why AsyncAPI Specification? An open-source async standards that enables creation of real-time messaging / event-driven applications for the telecom industry 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 9
10. Async API - Protocol Agnostic • AMQP • Kafka • WebSocket • NATS • MQTT • STOMP • … 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 10 Piloted via Catalyst Program
11. Why AsyncAPI matter to the Telecom Industry 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 11
12. Telecos deal with unprecedent volumes and complex environments 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 12
13. Service activation for 5G slice or VPN today is fundamentally an asynchronous process. Today we uses a monitor-based pattern which is suboptimal solution. 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 13
14. Autonomous network’s closed loop orchestration is fundamentally asynchronous 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 14
15. Event-driven architecture is an optimal paradigm for Microservice based inter-process communication 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 15
16. End to end orchestration of product ordering and network provisioning can use either orchestration or choreography pattern 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 16
17. Reactive strangler pattern to effectively migrate legacy systems 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 17
18. AI-based processing of events enriching the event stream 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 18
19. REST APIs vs Event APIs 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 19 API Calls are sent messages Each message is bound to a contract Asynchronous Event systems don’t necessarily expect request/response Producer & Consumer completely decoupled Reactive to a change/action Broker Communication Channels Channels Product Inventory Product Catalog Product Order Capture and Validation Event APIs API Gateway Channels Product Inventory Product Catalog Product Order Capture and Validation API calls are sent messages Each message follows a contract Synchronous API contracts are always request/response Producer / Consumer coupled Interface to an eco-system Direct Communication REST APIs
20. Events vs Commands 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 20 Publisher Consumer Consumer Consumer Channel Event Immutable state and value of a particular entity, which occurred during operation among services. Asynchronous form of call, where it contains instructions of telling the recipient what to do, which may cause a change of state in the system. Command
21. Commands and Notification Patterns 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 21 In TMForum AsyncAPIs both patterns Event & Command are being used Commands are being used to map the standard REST operation ones Events are being mapped against the TMF Open API “Notifications”
22. Mapping of REST Verbs to Async Commands 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 22 Command – Reply Pattern request channel command response channel kafka Requestor Replier reply In TMForum AsyncAPIs commands are implemented and mapped against the standard verbs (retrieve (GET {resource}), list (GET {collection}), create (POST), patch (PATCH), delete (DELETE))
23. Async API Pattern 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 23 • In TMForum AsyncAPIs every command & response is being assigned a to a channel • The channel name is following the agreed pattern • The channel name is appended with the “commandRequest” if it corresponds to the “request/command” • The channel name is appended with the “commandReply” if it corresponds to the “command response” • The “notifications” channel is following the “notificationEvent” name pattern
24. Open API and Async API Profiles! • OAS is used to specific synchronous REST APIs • Async API is used to for Event Driven Applications • 2 profiles one for each API Style • Start with same Schemas 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 24
25. Async API Certification 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 25 CTKs and Conformance Profile are developed for Async APIs Async APIs will become accessible form the redesigned Open API table over time as they are produced. Async APIs CTK’s will enable Event Driven Architecture API implementations to be certified supporting different protocols – but first Kafka
26. Async API CTK & VS - Architecture 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 26 Async API Virtual Service Virtual Service Observability Tools Consumer Producer Subscribe Topic <entity>.commandReply Publish Topic <entity>.commandRequest Notification Topic <entity>.notificationEvent Async API CTK Report Generator Conformance Tests Request Reply specmatic.yaml Payload validation Publish Verify Notification Verify CHANGE_ME.json 1 Test data jsons 2 3 4 5 6 8 9 Developer Notifier 7 In-memory Broker
27. Live Demo 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 27
28. Thank you! Naresh Jain Pierre Gauthier Founder & CEO, Specmatic Chief API Architect - TM Forum naresh@specmatic.io pgauthier@tmforum.org 22-12-2024 © 2024 - TM Forum & Specmatic - All Rights Reserved 28