Голое `invalid_request` — это не ошибка. Это снятие с себя ответственности.

Голое `invalid_request` — это не ошибка. Это снятие с себя ответственности.

Разработчик в 2 часа ночи не должен гадать, что сломалось. Ему нужны 4 вещи:
1. что именно не так;
2. где именно;
3. как исправить;
4. можно ли повторить запрос без сюрпризов.

Если этого нет, вы продаете не API, а дополнительную работу поддержки.

Что делать нормально:
- писать ошибки по шаблону: код, поле, причина, ожидаемое значение;
- отделять `client error` от `server error`;
- давать пример исправленного запроса;
- делать ответы предсказуемыми, даже скучными. Это плюс, не минус.

Главная метрика онбординга — время до первого успешного вызова. Не «сколько прочитали документацию», а сколько минут ушло до первого working request.

Практический вывод простой: чем меньше человек думает над вашей ошибкой, тем дешевле вам обходится внедрение. Чем больше думает — тем больше у вас скрытых затрат на поддержку, фоллоу-апы и потерянные интеграции. ⚙️