DX ломается не в API, а в первом “попробую руками” шаге

DX ломается не в API, а в первом “попробую руками” шаге

Time-to-first-call для дева — это не маркетинговая метрика, а проверка: можно ли за 5 минут понять, как авторизоваться, куда слать запрос и где увидеть ответ. Если для этого нужен PDF, тикет в саппорт и догадки по полям, он уйдёт.

Что обычно чинит onboarding:
— один короткий quickstart без воды;
— живой пример запроса и ответа;
— понятная схема auth: ключ, токен, подпись;
— ошибки в формате, который можно сразу залогировать;
— sandbox или тестовый режим без риска сломать данные.

Что портит DX сильнее всего:
— разные названия одного и того же объекта в docs, SDK и UI;
— примеры только на одном языке;
— скрытые обязательные поля;
— ответы API без кода ошибки и человеческого текста;
— “интеграция по запросу” вместо self-serve.

Если дев не может дойти до первого рабочего запроса без внешней помощи, это не плохой пользователь — это плохой путь. Сначала уберите трение, потом добавляйте фичи.