Голое `invalid_request` — это не ошибка, а отписка.

Голое `invalid_request` — это не ошибка, а отписка.

Если разработчик в 2:00 ночи подключает ваш API и видит только код без причины, он не «разберётся сам». Он уйдёт в угадайку, потом в поддержку, потом — к конкуренту.

Что должно быть в нормальной ошибке:
- что сломалось;
- где именно;
- почему это произошло;
- как исправить;
- пример корректного запроса.

Лучший ориентир — RFC 9457: у ошибки должен быть не только статус, но и человекочитаемое объяснение. Не «400 Bad Request», а понятное сообщение + поле `details` + ссылка на документацию. Это не косметика, а часть DX.

И ещё одна метрика, которую любят недооценивать: время до первого успешного вызова. Если его можно сократить на 20 минут — вы уже улучшили онбординг сильнее, чем очередным «улучшением интерфейса». ⚙️

Предсказуемый, скучный API — это комплимент. Значит, его можно использовать без переписки в поддержке.