Skip to content

API создания плейсмента ​

Каждый запрос должен быть авторизован через Header:

http
Authorization: Bearer {apiToken}

{apiToken} — API-ключ, который вы создаёте в кабинете паблишера: Аккаунт → API keys, со скоупом widgets:write. Он показывается только один раз. Подробнее: API-ключи.

Создать плейсмент ​

http
POST https://api.adexium.io/api/v1/widget/create
ПолеОбязательноеОписание
nameдаНазвание плейсмента
typeдаТип плейсмента, см. таблицу ниже
adFormatдаФормат рекламы; должен подходить к типу, см. таблицу ниже
siteUrlдаВалидный http(s) URL: публичная ссылка t.me на ваш Mini App или бота, ваш сайт или источник трафика
telegramBotIdдля TMA и BOTЧисловой ID вашего бота (для Mini App — бота, которому он принадлежит): цифры до : в токене бота от @BotFather. Передавайте только число, никогда не токен. Это должен быть бот из siteUrl
typeadFormat
TMA — Telegram Mini AppINTERSTITIAL или PUSH_LIKE
BOT — Telegram-ботBOT_MESSAGE
WEB_POPS — сайт, попандерWEB_POPS
WEB_INPAGE — сайт, in-page уведомленияWEB_INPAGE
DIRECT_LINK — прямая ссылкаWEB_POPS

Пример запроса:

http
POST https://api.adexium.io/api/v1/widget/create
json
{
    "adFormat": "INTERSTITIAL",
    "name": "Your placement name",
    "type": "TMA",
    "siteUrl": "https://t.me/yourBot/yourApp",
    "telegramBotId": "1234567890"
}

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

json
{
  "id": 6555,
  "uid": "67634220-b46d-4951-a5bc-38961114732e",
  "name": "Your placement name",
  "siteUrl": "https://t.me/yourBot/yourApp",
  "adFormat": "INTERSTITIAL",
  "type": "TMA",
  "createdAt": "2025-09-14T13:50:08+00:00"
}

uid — Placement ID (WID), который вы вставляете в код рекламы; id — числовой ID для API статистики.

Плейсмент TMA или BOT без telegramBotId или с ID другого бота, чем в siteUrl, отклоняется с ошибкой валидации поля telegramBotId.