Утро, релиз горит, разработчик не спал, не ел и уже ненавидит ваш продукт.

Утро, релиз горит, разработчик не спал, не ел и уже ненавидит ваш продукт.
Он дергает API — и в ответ получает ледяное `invalid_request`.

Кто виноват?
Что сломалось?
Как чинить?
Ответа нет. Есть только сорок минут шаманства, открытый чат с поддержкой и желание удалить ваш SDK из памяти навсегда.

Вот где обычно и умирает «хороший DX»: не на сложной документации, а на первом тупом сообщении об ошибке.
Ошибка должна не пугать, а проводить за руку.
Не «что-то пошло не так», а: что именно, почему, как исправить, куда смотреть дальше.

Самый скучный API — часто самый любимый. Потому что предсказуемый. Потому что не устраивает драму в два часа ночи. 😌

Метрика тут тоже без романтики: время до первого успешного вызова.
Если оно длинное — у вас не онбординг, а квест на выживание.

Минимум, который спасает нервы:
- понятный код ошибки
- человекочитаемое объяснение
- пример исправления
- ссылка на нужный раздел, а не на портал страданий

И да, RFC 9457 — это не только для галочки. Это способ перестать писать сообщения, которые читаются как пассивная агрессия.