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

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

Что произошло: ошибка есть, смысла — нет.
Почему это плохо: человек не понимает, где сломалось, сколько ему ещё гадать и можно ли вообще успеть к дедлайну.

У такого DX обычно три последствия:
- сорок минут на поиск причины вместо исправления;
- лишняя нагрузка на поддержку;
- раздражение у того, кто ещё вчера хотел интегрироваться с вами без боли.

Главная метрика здесь не «количество эндпоинтов» и не «красота документации».
Главная — время до первого успешного вызова. Если оно растёт, онбординг уже трещит.

Хорошая ошибка — это не `invalid_request`.
Это короткий, человеческий ответ: что сломалось, где, почему это могло случиться и что делать дальше. Без загадок. Без ритуала вызова поддержки. ⚙️

Скучный API — не провал. Это комплимент.
Значит, люди не тратят ночь на расшифровку ваших сообщений и быстрее доходят до результата.