REST API: понятные эндпоинты

Хорошее API объясняет себя само

Я стараюсь, чтобы по одному URL было понятно, что произойдёт:

• существительные во множественном числе: /users, /posts;
• глаголы - это HTTP-методы (GET, POST, PATCH, DELETE), а не часть пути;
• коды ответов честные: 200, 201, 400, 404, 409, 500;
• ошибки - в едином формате JSON с полем и причиной.

Консистентность важнее красоты: лучше один скучный стиль на весь проект, чем пять разных подходов в соседних роутах.