`invalid_request` — это не ошибка. Это издевательство над человеком, который в 2:07 ночи пытается запустить ва

`invalid_request` — это не ошибка. Это издевательство над человеком, который в 2:07 ночи пытается запустить ваш API и очень не хочет с вами познакомиться лично.

Классический black case: разработчик подключается к сервису, ловит голое «что-то пошло не так», сорок минут тыкает вслепую, потом пишет в поддержку уже не как клиент, а как человек, которому испортили ночь. И тут проблема не в нем. Проблема в вашем DX.

Хороший API — не тот, что «умный». Хороший — тот, что скучный, предсказуемый и честный. Ошибка должна говорить:
что сломалось,
почему сломалось,
что сделать дальше,
куда смотреть глазами, а не шаманить.

Если ваш ответ не помогает дойти до первого успешного вызова быстро — вы теряете людей еще на входе. А потом удивляетесь, почему интеграции «долго согласуются» и «зависают в тесте». 🙃

Нормальная ошибка — это не роскошь, а анти-хаос. И да, это тот редкий случай, когда «скучно» = комплимент.