Client API

Клиентский API выдаёт короткие коды по bot_id и user_tg_id для сценариев rewarded и direct link.

Эндпоинт

POST https://api.botads.app/client/v1/codes

curl -X POST https://api.botads.app/client/v1/codes \
  -H "Authorization: Bearer <api_token>" \
  -H "Content-Type: application/json" \
  -d '{"bot_id": "123456789", "user_tg_id": "799001234"}'

Пример ответа:

{
  "code": "Abc123xxxx",
  "expires_in": 3600,
  "expires_at": "2024-05-26T12:00:00Z"
}

• code включает префикс бота и случайный суффикс. TTL по умолчанию — 1 час (3600 секунд).

• user_tg_id — строка с цифрами (Telegram user id), передавайте как строку.

• Авторизация: Authorization: Bearer <api_token> бота (строка api_token, это не JWT; если в OpenAPI увидите bearerFormat: JWT, это артефакт генерации — значение токена остаётся opaque).

Ответы и ошибки

• 200 — код создан.

• 400/401/403/404/429/500 — ошибки валидации, авторизации или ограничения. См. Ошибки и лимиты.

Ошибки

Список кодов и рекомендации: Ошибки и лимиты.