Я люблю, когда API не пытается быть «умным», а просто помогает сделать первый успех без боли. Голое `invalid_r

Я люблю, когда API не пытается быть «умным», а просто помогает сделать первый успех без боли. Голое `invalid_request` — это не ошибка, это раздражитель. Уставший разработчик в 2 ночи не должен играть в квест «угадай, что я имел в виду».

В хорошей интеграции ошибка отвечает на 3 вопроса сразу: что сломалось, почему это случилось, как починить. Без этого вы теряете не только время, но и доверие. А доверие в онбординге — это вообще ваша конверсия.

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

И да, скучный API — это комплимент. Когда всё предсказуемо, понятно и без сюрпризов, интеграция едет как по рельсам. 🚂

Если хотите, чтобы вас не проклинали в ночных чатах, пишите ошибки как для живого человека: что, где, что делать дальше. Это не косметика. Это продукт.