Curated Tech Reading Map

Find your next tech book to read

Book

Web API: The Good Parts

Takaaki Mizuno

Buy on Amazon* The link above is an advertisement via Amazon Associates.

Summary

A Japanese-language guide to designing, developing, and operating Web APIs by Takaaki Mizuno. It argues that an API can become hard to use through its design choices alone, and that this also makes maintaining and operating it after release difficult, so designing it beautifully matters. Working from the idea that a beautifully designed API is easy to use, easy to change, robust, and not embarrassing, the book clarifies how to design and operate an API more effectively, and what to watch for in order to avoid common traps and pitfalls. Its target is the simple type of API where accessing a URI returns data such as XML or JSON, namely the XML-over-HTTP and JSON-over-HTTP styles. Readers come away knowing the thinking and techniques behind Web API design.

Target Readers

  • Developers settling the design of a JSON-over-HTTP or XML-over-HTTP API before release, when that design will also decide how hard it is to maintain and operate afterward
  • Engineers working on RESTful API development who need to know the common traps and pitfalls in endpoint design and HTTP method use
  • Developers who need explicit criteria for judging an API design: easy to use, easy to change, robust, and not embarrassing

Tags

#api-design#rest#http

Colophon

Publisher
O'Reilly Japan
ISBN
978-4873116860
Published
Nov 2014
List price
¥2,420incl. taxMay differ from the actual selling price on Amazon

Get this book

* The link above is an advertisement via Amazon Associates.

Prerequisites

Next Books