Don't worry about what is or isn't REST; focus on building pragmatic, useful APIs.

Статья о практических нюансах проектирования REST-like API. Есть моменты, где можно похоливарить, но всяко лучше чем очередная дискуссия “Как правильно делать REST API”.

Например, почему:
• не стоит везде использовать вложенные ресурсы
• не стоит использовать map-структуры
• не стоит возвращать 404, если ресурс не найден - интересный кейс внутри, посмотрите обязательно
• id лучше дополнять префиксом-указателем на тип сущности и представлять в виде стрингов

#API