API Development: Evolving Prospects and Future Outlook

Transcript

1. API Development: Evolving Prospects and Future Outlook 1
2. codecentric AG Hoher Wall 15 44137 Dortmund Telefon: +49 (0) 151. 10 86 70 74 Daniel Kocot Head of API Experience & Operations AsyncAPI Ambassador daniel.kocot@codecentric.de https://www.codecentric.de/standorte/dortmund/dortmund- team#daniel-kocot https://danielkocot.substack.com https://www.sigs.de/autor/daniel.kocot https://danielkocot.github.io Innovative - Trustful - Competent - Pragmatic 2
3. Warm-Up Questions 3
4. Selfie time! 4
5. Are you using APIs already? 5
6. Are you utilising any API styles other than the resource-driven ones? 7
7. Is an API Management solution a part of your API Development? 9
8. API Development 11
9. Definition 12 DEFINITION CREATION IMPLEMENTATION TESTING AND DEBUGGING DOCUMENTATION AND DEPLOYMENT
10. Why do organisations invest in API Development? 13
11. Why do organisations invest in API development? 14 Costs, turnover, growth Automation, Better time to market Added value from data Regulation Benefiting from new technologies
12. API Development is a key driver in the context of transformation. 15
13. Continuous (Application) Transformation 16
14. API first 17
15. API first 18 PRIORITISING APIS WITHIN THE ORGANISATION APIS BECOME A MAIN PART OF THE BUSINESS MODEL OF THE ORGANISATION API FIRST IS NOT A PARADIGM FOR YOUR DEVELOPMENT TEAM!
16. API as a Product API Product 19
17. Definition 20 VALUE PROPOSITION ANALYTICS AND MAYBE SOME KIND OF MONETISATION OWNERSHIP AND LIFECYCLE MANAGEMENT DOCUMENTATION AND DEVELOPER EXPERIENCE
18. But an API is not the panacea 21
19. APIs are not the panacea 22 In some situations they are not the best fit Security Dependencies Complexity
20. Integration 23
21. Application Integration 24
22. Application Integration 25 DISTRIBUTION OF DATA AND INFORMATION BETWEEN APPLICATIONS ENTERPRISE INTEGRATION PATTERNS
23. Data Integration 26
24. Data Integration 27 DISTRIBUTION OF DATA BETWEEN DATA STORES EXTRACT, TRANSFORM, LOAD (ETL) CHANGE DATA CAPTURE(CDC)
25. Unfortunately, APIs serve as the medium for data transmission. 28
26. How dull! But we all adore technology! 29
27. Thus, discussions about designing APIs morph into Kafkaesque, technology- driven dialogues. 30
28. Content of technology-driven dialogues 31 HTTP/REST SOAP Kafka GraphQL
29. But generally, that doesn’t address any customer needs 32
30. Stop immediately! 33
31. Let’s get things right from the start! 34
32. Data 35
33. Daily Routine: Searching for data and creating new value for the organisation 36
34. Discovery of Data 37
35. Awareness of Data Products and Data Contracts 38
36. Data what? 39
37. Data Product 40 VALUE DRIVEN OUTPUT USER INTERACTION CROSS- DISCIPLINARY DEVELOPMENT MONITORING AND MAINTEANCE
38. Data Product – Schematic View 41
39. Data Contract 42 FORMAL AGREEMENT SCHEMA DEFINITION DATA GOVERNANCE INTERFACE SPECIFICATION
40. More Details 43
41. Only data products that add value can lead to equally valuable API products. 44
42. DataOps 45
43. Definition 46 AGILE METHOLOGY COLLABORATION AND COMMUNICATION AUTOMATION AND MONITORING CONTINOUS IMPROVEMENT
44. Focus on Developer Success 47
45. Data Contracts as the Foundation 48
46. However, API descriptions require data schemas/models. 49
47. Generate data models from data contracts. 50
48. APIs 51
49. Every API is driven by the need to access data. 52
50. Two questions need to be addressed. 53
51. There are two questions to answer. 54 WHO IS INTERESTED IN ACCESSING THE DATA? WHY DO THEY WANT TO ACCESS DATA?
52. Everything we do now is becoming consumer-centric 55
53. API Thinking 56
54. Classical Design Thinking 57 Empathise Define Ideate Prototype Test
55. API Development API Thinking 58 Empathise with stakeholders Data definition API definition API endpoint and backend implementation Test by stakeholders
56. In the following, we will focus solely on API products. 59
57. Three dimensions of API development 60
58. Design first 61
59. Design first Principles 62 Planning before coding Collaboration Early Validation Consistency and Standardization
60. Code first 63
61. Code first Principles 64 Development approach Automatic Documentation Generation Flexibility and Speed
62. Prototype first 65
63. Prototype first Principles 66 Early visualisation Feedback collection Cost efficiency Faster iterations
64. API Interaction Patterns 67
65. Definition 68 Different API interaction patterns exist to accommodate various use cases, requirements, and preferences of API consumers. These pattern provide different ways for clients to interact with APIs and can be chosen based on factors such as the nature of the application the desidered level of control and flexibility, and the specific goals of the API design
66. Overview 69 Resource / Hypermedia Tunnel Query Event-Based
67. Resource / Hypermedia 70 EXECUTE A SPECIFIED SET OF METHODS ON REMOTE RESOURCES. HTTP, ODATA, GRPC
68. Tunnel 71 CALL A PROCEDURE/COMMAND ON A REMOTE SERVER AS YOU WOULD LOCALLY CALL A FUNCTION IN YOUR PROGRAMMING LANGUAGE SOAP, XML/JSON-RPC,GRPC, ODATA
69. Query 72 FORMULATE A QUERY AGAINST A REMOTE DATASET AS IF THE API WERE A DATABASE (CF. SQL) HTTP (QUERY), ODATA, GRAPHQL
70. Event-Based 73 FETCH EVENTS COMING TO AND FROM MESSAGE BROKER AMQP, MQTT, CLOUDEVENTS
71. The goal of API development is essentially to deploy a service along with an API. 74
72. However, developers don't want to deal with YAML or JSON files. 75
73. These should merely be artefacts created by automated processes. 76
74. First Idea 77
75. Code-first approach based on the generated data model 78
76. Beneficial Impacts 79 THE DEVELOPMENT TEAM CAN STICK TO ITS STACK. THE API DEFINITION IS GENERATED BY THE FRAMEWORKS BEING USED.
77. Adverse Impacts 80 TEAMS ON BOTH THE PROVIDER AND CONSUMER SIDES CANNOT DEVELOP CONCURRENTLY. THE LIBRARY USED TO GENERATE THE DEFINITION DOESN'T FULLY SUPPORT THE ENTIRE FEATURE SET OF THE SPECIFICATION.
78. Second Idea 81
79. Interface first 82
80. Interface first 83 FOUNDED ON DESIGN FIRST PRINCIPLES DEFINING ENDPOINTS VIA PROGRAMMATIC, TYPE-SAFE, AND PLATFORM- AGNOSTIC INTERFACES OPPORTUNITY TO CONSOLIDATE ALL OUTPUT PORTS OF A DATA PRODUCT WITHIN A SINGLE INTERFACE DESCRIPTION. ADAPT THIS INTERFACE DESCRIPTION BASED ON THE PROVIDED API INTERACTION PATTERNS. IMPLEMENT THE SERVICES USING THE SUPPORTED PATTERNS, ALIGNING WITH THE PROGRAMMING EXPERTISE OF EACH TEAM.
81. Introduction to new (additional) tooling 84
82. Interface First Tooling 85 Mircosoft TypeSpec TaxiLang Fern
83. Microsoft TypeSpec 86
84. Description 87 Build a first to serve a s a language for describing cloud service APIs Ability to facilitate the generation of other API description languages Provides extensible core language primitives to describe API shapes Evolving language so breaking changes can still happen
85. Microsoft TypeSpec 88
86. Microsoft TypeSpec 89
87. Interface first at a glimpse 90 Beginning with a data model supported by Data Products and Data Contracts Describe the interfaces for a data model in a programmatic and type-safe manner. Available solutions so far: Microsoft TypeSpec, TaxiLang, Fern
88. APIOps 91
89. Focus on Developer and Business Success 92
90. The idea of APIOps 93
91. API Operations Pipeline first iteration 2020 94
92. API Operations Pipeline Second Iteration 95 • Bundling of Definition Prepare • Use of Linters • Redocly for generic structure • Spectral or Vacuum for specific rules, like org-related and OWASP Top 10 • Check for Break Changes with oasdiff Validate • Contract Testing • Using Prism for Mocking • Testsuite covered by Portman and Newman Test • Deploying the definition to an API Gateway including needed transformations Deploy • Publishing the definition and additional information to an IDP and/or Marketplace Publish
93. Integrate APIOps with DataOps 96
94. Ideas 97 UNIFIED PROCESS MANAGEMENT COLLABORATIVE DEVELOPMENT ENVIRONMENT AUTOMATED DATA PIPELINE AND API PIPELINE SHARED GOVERNANCE AND MONITORING
95. Conclusion 98
96. Conclusion 99 API Development is a challenging and demanding task. Tooling always complements the underlying methodology. Initially, an API Management solution is not required for the development of APIs. To create high-quality APIs, adhere to standards and incorporate concepts from Data Mesh.
97. 100 codecentric AG | Hochstraße 11 | 42697 Solingen Creating the digital future together. Thank you!
98. References 101 Cover Slide: Photo by Drew Beamer on Unsplash Slide 48: Photo by Emily Morter on Unsplash Slide 12: Photo by Franki Chamaki on Unsplash Slide 19: Photo by NASA on Unsplash Slide 21: Photo by Markus Winkler on Unsplash Slide 24: Photo by Sandro Gonzalez on Unsplash Slide 33: Photo by N. on Unsplash Slide 34: Photo by Dimitri Karastelev on Unsplash Slide 55: Photo by Aditya Chinchure on Unsplash Slide 91: Photo by Clay Banks on Unsplash