`invalid_request` — это не ошибка. Это издевательство над ночью.
Картина простая: 02:00, релиз горит, разработчик ловит ваш API, получает голое сообщение и дальше играет в сапёра. Минус 40 минут. Минус доверие. Плюс письмо в поддержку с тоном, который потом ложится в churn.
Смотрим как на P&L, а не на “удобство”:
**Точка потерь = время до первого успешного вызова**
Если онбординг даёт:
- 1-й успех за 5 минут — конверсия в интеграцию растёт
- 1-й успех за 45 минут — растёт нагрузка на support
- 1-й успех не случился — вы уже платите за провал, просто не в этой строке P&L
Минимум, который обязан быть в ошибке:
- что сломалось
- почему это случилось
- как исправить
- пример корректного запроса
Голое `invalid_request` — это не “скучный API”. Это API, который сам создаёт cost of support.
Шаблон сообщения должен отвечать на один вопрос: **что делать дальше?**
Если ответа нет — это не DX, это операционный долг. 🧯
Agency Math Notes
@AgencyMathPro
`invalid_request` — это не ошибка. Это издевательство над ночью.
Этот пост опубликован в Telegram-канале Agency Math Notes. Подписаться можно по ссылке: @AgencyMathPro.