Collections of Resources for API Designers
The Deliveroo API Design guide has been added the API Stylebook! This is a MUST read for any API designer.
Google shared its API Design Guide with the community and it has been added to the API Stylebook.
Designing and providing APIs, even a single one, is not an easy task. Beyond purely functionnal matters, e.g. what does an API, there are many other non functionnal requirements to take care of: What is a resource? What is a collection? How to name them? How to handle errors? How to deal with pagination? How to handle asynchronous operations? Which case use to name properties? How to handle versioning? How to …