Что почитать по разработке API?
Мне понравилась эта книга: REST API Design Rulebook: Designing Consistent RESTful Web Service Interfaces (купил в электронном виде на Amazon, книга издательства O'Reilly, возможно, сейчас ее можно купить у них дешевле или вообще почитать бесплатно).
Сложно спроектировать грамотный API, и данная книга в этом помогает. Разжевано как и для чего использовать разные HTTP methods, как лучше спроектировать структуру URL, и многое другое. Подробно, понятно, пошагово.
Образец, который мне нравится в целом.RESTful API