Based on RESTful API Design — Step By Step Guide
- Держать простым
- Не забывать про методы
- Использовать корректные статус-коды в ответах
- Ресурсы как существительное, не глагол
- Использовать множественное значение
- Использовать пагинацию, а не выдавать всё разом
- В коллекциях возвращать информацию о пагинации
- Использовать квери-параметры для GET запросов, если нужно сузить выборку