ВАШЕ ОШИБОЧНОЕ СООБЩЕНИЕ ДОЛЖЕН ЧИТАТЬ УСТАВШИЙ ЧЕЛОВЕК В ДВА НОЧИ

ВАШЕ ОШИБОЧНОЕ СООБЩЕНИЕ ДОЛЖЕН ЧИТАТЬ УСТАВШИЙ ЧЕЛОВЕК В ДВА НОЧИ

Если в ответ на сбой API человек видит только `invalid_request`, это не ошибка — это тупик.
В 02:00 разработчик не хочет «диагностики системы». Он хочет быстро понять: что сломалось, где искать и как продолжить.

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

Полезный шаблон для ошибок:
- что произошло;
- почему это случилось;
- как исправить;
- пример корректного запроса;
- ссылка на next step.

Это почти RFC 9457, только без бюрократии и с уважением к человеку по другую сторону экрана.

Предсказуемый API — это не скучно. Это комплимент.
Потому что «скучный» сервис не заставляет гадать, не ломает контекст и не съедает внимание в самый дорогой момент. 🔧