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

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

Не «какое поле сломано».
Не «что исправить».
Не «как повторить запрос».
Просто мусор в JSON и злой человек на другой стороне экрана.

Вот где начинается настоящая боль. Не в коде. В сообщении об ошибке.

Хороший API не умничает. Он объясняет. По-человечески.
Что не так. Где именно. Какой был expected. Что пришло. Как это воспроизвести. Если есть `trace_id` — тащите его в ответ. Если есть ссылка на доку — тащите и её.

RFC 9457 — не ради красоты. Это попытка перестать кормить разработчика гаданием на кофейной гуще. Ошибка должна быть полезной, а не загадочной.

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

Скучный, предсказуемый API — это комплимент.
Потому что в 2:13 ночи никому не нужен драмтеатр. Нужен ответ, который чинит проблему, а не создает новую. 🔥