`invalid_request` — это не ошибка.

`invalid_request` — это не ошибка.
Это крик в пустоту: «догадывайся сам».

Ночью у разработчика не растёт терпение,
растёт CAC на онбординг:
1 ошибка → 1 поиск → 1 тикет → 1 злой Slack.

Формула дня для DX:

**TTFW = время до первого успешного вызова**
чем выше TTFW, тем дороже вход в API.

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

Плохой API =
`400` + тишина.
Хороший API =
`400` + диагноз + следующий шаг.

Предсказуемый, скучный API — это не скучно.
Это когда у пользователя не возникает желания писать в поддержку в 02:00. 😴