Ошибка `invalid_request` — это не DX. Это способ потерять интеграцию в 2:00 ночи.

Ошибка `invalid_request` — это не DX. Это способ потерять интеграцию в 2:00 ночи.

Если разработчик видит голый код без контекста, он:
- гадает, что сломал,
- тратит время на дебаг,
- пишет в саппорт вместо того, чтобы запустить трафик.

Нормальная ошибка должна отвечать на 3 вопроса:
1) что именно не так,
2) где это сломалось,
3) как исправить.

Практика простая: делайте ошибки в стиле RFC 9457, но без канцелярита:
- понятный `title`,
- `detail` на человеческом языке,
- `invalid_params` с указанием поля и ожидаемого формата,
- `request_id` для быстрого поиска в логах.

И да, главный onboarding KPI — не регистрация в кабинете, а time to first successful call. Чем быстрее SDK/API дает первый успех, тем меньше отвал на старте.

Скучный API — это комплимент. Значит, им пользуются без боли. ⚙️