AJR/TechradarDev
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

adopt api-first design

Browse Source
This commit is contained in:
Bastian Ike
2022-04-13 10:55:49 +02:00
committed by resah
parent e50fdcc91c
commit e87d496afc
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
radar/2022-03-28/api-first-design-approach.md Normal file
View File

@@ -0,0 +1,10 @@
---
title: "API-First Design Approach"
ring: adopt
quadrant: methods-and-patterns
---
The API of any software we develop shapes in which way developers, teams, customers and users interact with our software.
No matter if a Frontend-API like GraphQL, a rpc-API like gRPC or an internal API published by a module in a larger project or shared library, messing the API up always creates headaches and is hard to correct.
If we stick to semantic versioning, it's actually pretty impossible to change a once-published API without breaking consumers.
By todays standards we priorize API design before actual development, to be clear on how our software interacts, and thus move this pattern to "adopt".