Что почитать по разработке API?

Question

[unfapable]

Очень давно уже был похожий вопрос Что почитать по созданию RESTful API новичку ?
Но с тех пор многое наверняка поменялось, как минимум появились новые материалы. Интересует как правильно разрабатывать собственные API.

Answer 1

[Евгений]

Мне понравилась эта книга: REST API Design Rulebook: Designing Consistent RESTful Web Service Interfaces (купил в электронном виде на Amazon, книга издательства O'Reilly, возможно, сейчас ее можно купить у них дешевле или вообще почитать бесплатно).

Сложно спроектировать грамотный API, и данная книга в этом помогает. Разжевано как и для чего использовать разные HTTP methods, как лучше спроектировать структуру URL, и многое другое. Подробно, понятно, пошагово.

Answer 2

[xmoonlight]

Образец, который мне нравится в целом.
RESTful API

Answer 3

[Igor Kalashnikov]

а еще поглядите на swagger:

editor.swagger.io

это и готовый пример, и способ документации, и тестирования, и кодогенерации.

Answer 4

[entermix]

Что почитать по созданию RESTful API новичку ?
Где найти актуальный путеводитель по созданию RESTfull API?

Answer 5

[Den]

Есть годная книга от Phil Sturgeon (The League of Extraordinary Packages, PHP The Right Way, Ex-PHP-FIG, Ex-CodeIgniter, Ex-FuelPHP, Ex-PyroCMS.)
https://apisyouwonthate.com