«invalid_request» — это не ошибка, это издевательство в 2:00 ночи.

«invalid_request» — это не ошибка, это издевательство в 2:00 ночи.
Разраб уже на нервах, релиз горит, а API отвечает в стиле: «дальше сам догадайся».

Нормальный DX — это когда ошибка говорит: что сломалось, где, почему и как чинить.
Не “403”, а “подпись не сошлась: проверь timestamp и ключ”.
Не “bad request”, а “поле offer_id пустое, вот пример запроса”.

Главная метрика онбординга — не красота доки, а time to first success.
Если до первого рабочего запроса человек проходит квест на выживание — вы теряете его быстрее, чем льют кривой трафик в чёрный оффер.

Скучный API — комплимент.
Потому что в арбитраже скучно = предсказуемо = меньше факапов = меньше писем в саппорт в духе «у вас опять всё сломалось» 😏