Webhooks, ошибки и rate limits

Postback-конверсии, формат ошибок и ограничения API

Postback конверсий (CPA)

Для CPA-кампаний платформа принимает postback-уведомления о конверсиях. Эндпоинт выдаётся в кабинете кампании; вызовы идемпотентны.

Рекламные ссылки ведут через короткий путь /c/{id} — переход фиксируется и редиректит на целевой URL. Аномальные клики фильтруются антифродом.

{
  "code": "channel_rights_missing",
  "message": "Bot is missing required rights",
  "details": { "missing": ["post_messages"] }
}

HTTP	Когда
400	Ошибка валидации тела/параметров
401	Нет или просрочен токен, невалидный initData
403	Недостаточно прав (роль/permission)
404	Ресурс не найден
409	Конфликт (например, email занят)
429	Превышен rate limit
500	Внутренняя ошибка

Webhook Telegram: до 100 rps с burst 50.
Повторное использование отозванного refresh-токена инвалидирует всю цепочку сессий.
Идемпотентные мутации: тот же idempotency-key → тот же результат без побочных эффектов.