Два часа ночи. У разработчика горит релиз. Он дергает ваш API и получает в лоб голое `invalid_request`.

Два часа ночи. У разработчика горит релиз. Он дергает ваш API и получает в лоб голое `invalid_request`.

Это не ошибка. Это плевок в лицо.
Потому что дальше начинается не отладка, а шаманство: что сломалось, где, почему, как это чинить — ноль ответа.

Контекст: у вас есть DX-проблема.
Действие: заменить мусорные ошибки на нормальный формат — RFC 9457-style problem details, плюс человеческий текст, код, поле, причина, пример исправления. Не “что-то не так”, а “`email` не проходит валидацию: ожидается формат `name@domain.com`”.

Результат: меньше тикетов, меньше гадания, быстрее первый успешный вызов. И да — это и есть ваша реальная метрика онбординга: не “сколько людей зарегистрировались”, а сколько дошли до первого working request без помощи саппорта.

Предсказуемый, скучный API — это не недостаток. Это комплимент.
Потому что ночью никому не нужен креатив. Нужна ясность. 🧱