DX трекера начинается не с API, а с первого запроса без помощи саппорта

DX трекера начинается не с API, а с первого запроса без помощи саппорта

Если разработчик не может за 10–15 минут получить токен, найти базовый endpoint и выполнить GET /campaigns, он не «плохо читает docs». Это onboarding не довёл его до первого результата. Для affiliate-tooling первый успех — не регистрация, а рабочий запрос с понятным ответом.

Проверьте quickstart как чужой человек:
— где взять ключ и какие права ему нужны;
— какой минимальный запрос можно скопировать;
— что вернётся при 401, 403, лимите, пустом аккаунте;
— есть ли пример на Python или JS без SDK-магии;
— видно ли, sandbox это или боевой аккаунт.

Плохой DX часто прячется в мелочах: auth описан в одном разделе, лимиты — в другом, статусы ошибок — в PDF, а curl-пример не запускается из-за кавычек. Дев не будет собирать квест, он откроет конкурента или напишет в чат «скиньте пример».

Хороший тест: дайте docs человеку, который не знает продукт, и молчите. Если он задаёт вопрос раньше первого ответа API — это не вопрос к нему, это тикет в docs.

Финал простой: оптимизируйте не «полноту документации», а путь до первого полезного ответа. Всё остальное дев прочитает позже.