DEV Community

Cover image for Designing Web APIs
Kenta Takeuchi
Kenta Takeuchi

Posted on • Originally published at bmf-tech.com

Designing Web APIs

This article was originally published on bmf-tech.com.

Designing Web APIs is a book I read.

It's a book that offers perspectives on API design.

It covers not only the interface of API design but also starts from the very beginning.

  • When designing APIs, it's better to focus on what users can do rather than the mechanisms. Focusing on mechanisms can lead to complexity.
  • There was an explanation of a framework called Goal Canvas as an approach to uncovering API goals, which I thought was a good method.
  • API versioning patterns include path, domain, query parameters, custom headers, content negotiation, and consumer settings (storing settings for each consumer in the DB).

Top comments (0)