<b>DX ломается не в API, а в первом «ну тут всё понятно»</b>

<b>DX ломается не в API, а в первом «ну тут всё понятно»</b>

Плохой developer experience почти всегда начинается не с кода, а с догадок: где токен, как авторизоваться, какой endpoint трогать первым и что считать успехом.

Чтобы человек сделал первый рабочий запрос быстро, у него должны быть:
— один короткий quickstart без лишней теории
— готовый пример на 1–2 самых популярных языках
— понятная схема auth: где взять ключ, куда положить, как обновлять
— явный ответ: какой запрос проверяем первым и какой результат ждём

Сильный сигнал для дев-аудитории — не «у нас много функций», а «через 3 минуты у тебя уже есть ответ от сервиса». Если на входе нужен PDF, созвон и пять экранов текста, это уже не onboarding, а квест.

Отдельно проверь ошибки: они должны быть читаемыми. Не <code>500 internal</code>, а «неверный токен», «не хватает прав», «не найден campaign_id». Иначе человек идёт не в docs, а в Telegram саппорта.

Если хотите улучшить DX без редизайна продукта — начните с первого запроса, auth и ошибок. Именно там решается, останется разработчик с вами или закроет вкладку.