Ваше сообщение об ошибке читает уставший человек в два часа ночи.

Ваше сообщение об ошибке читает уставший человек в два часа ночи.

И если там просто `invalid_request`, вы теряете не только терпение разработчика — вы теряете его доверие к продукту.

3 шага, чтобы исправить DX без героизма:

1. **Назовите проблему человеческим языком**
Не «ошибка запроса», а что именно сломано: поле, формат, лимит, авторизация.

2. **Сразу дайте следующий ход**
Что проверить, как исправить, где посмотреть пример.
Ошибка без действия — это тупик.

3. **Сделайте поведение предсказуемым**
Один и тот же тип ошибки должен выглядеть одинаково всегда.
Скучный API — это не недостаток. Это комплимент. 🤝

Для платного продукта это особенно важно: хороший onboarding начинается не с красивой витрины, а с первого успешного действия. Если человек быстро понял, что делать, он остаётся дольше.

Мини-чек-лист для ошибки:
- что случилось
- почему это могло случиться
- как исправить
- куда идти дальше

Уставший человек ночью не хочет философии. Он хочет ясности.