Get the latest tech news

The Elements of APIs (2021)


Would you like the design a web API that is reliable and pleasant to use? I have some ideas for you. - Introduction - What problems are we trying to solve? - A shortcut - Establishing contracts - Requests and Responses - Resources - Side effects - Many nouns, few verbs - Designing Data - Relationships - Discoverability - Conclusion - Appendix: Versioning your API - Appendix: Versioning your Resources - Appendix: Authentication - Appendix: REST - Appendix: JSON:API - Appendix: Domain-Driven Design Read as one pag.

This is still a rough draft, but I wanted to share it while it's in progress. Please give it a look and let me know what you think. Thanks!

Get the Android app

Or read this on Hacker News

Read more on:

Photo of Elements

Elements

Photo of APIs

APIs

Photo of john holdun

john holdun

Related news:

News photo

Assassin's Creed Shadows team acknowledges elements "that have caused concern" among Japanese fans

News photo

A simple guide to HTML <head> elements

News photo

PostgREST Tutorial: APIs made easy