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 |
type | adFormat |
|---|---|
TMA — Telegram Mini App | INTERSTITIAL или 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/createjson
{
"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.