Маркетинг и продвижение (promotion)
Управление кампаниями, настройки ставок, учёт финансовых данных и настройки автоматических и медиа кампаний.
Синхронизация данных из базы данных происходит раз в 3 минуты. Изменение статуса происходит раз в 1 минуту. Изменение ставки происходит раз в 30 секунд. Внутри интервалов сохраняются последние изменения
Управление кампаниями, настройки ставок, учёт финансовых данных и настройки автоматических и медиа кампаний.
Синхронизация данных из базы данных происходит раз в 3 минуты. Изменение статуса происходит раз в 1 минуту. Изменение ставки происходит раз в 30 секунд. Внутри интервалов сохраняются последние изменения
Список акций{{ /api/v1/calendar/promotions }}
Возвращает список акций с датами и временем проведения
Authorizations:
query Parameters
startDateTime required | string <RFC3339> Example: startDateTime=2023-09-01T00:00:00Z Начало периода, формат |
endDateTime required | string <RFC3339> Example: endDateTime=2024-08-01T23:59:59Z Конец периода, формат |
allPromo required | boolean Default: false Показать акции:
|
limit | integer <uint> [ 1 .. 1000 ] Example: limit=10 Количество запрашиваемых акций |
offset | integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "promotions": [
- {
- "id": 123,
- "name": "скидки",
- "startDateTime": "2023-06-05T21:00:00Z",
- "endDateTime": "2023-06-05T21:00:00Z",
- "type": "regular"
}
]
}
}
Детальная информация по акциям{{ /api/v1/calendar/promotions/details }}
Возвращает подробную информацию о выбранных акциях
Authorizations:
query Parameters
promotionIDs required | string [ 1 .. 100 ] items unique Example: promotionIDs=1&promotionIDs=3&promotionIDs=64 ID акций, по которым нужно вернуть информацию |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "promotions": [
- {
- "id": 123,
- "name": "ХИТЫ ГОДА",
- "description": "В акции принимают участие самые популярные товары 2023 года. Карточки товаров будут выделены плашкой «ХИТ ГОДА», чтобы покупатели замечали эти товары среди других. Также они будут размещены под баннерами на главной странице и примут участие в PUSH-уведомлениях. С ценами для вступления в акцию вы можете ознакомиться ниже.",
- "advantages": [
- "Плашка",
- "Баннер",
- "Топ выдачи товаров"
], - "startDateTime": "2023-06-05T21:00:00Z",
- "endDateTime": "2023-06-05T21:00:00Z",
- "inPromoActionLeftovers": 45,
- "inPromoActionTotal": 123,
- "notInPromoActionLeftovers": 3,
- "notInPromoActionTotal": 10,
- "participationPercentage": 10,
- "type": "auto",
- "exceptionProductsCount": 10
}
]
}
}
Список товаров для участия в акции{{ /api/v1/calendar/promotions/nomenclatures }}
Возвращает список товаров, подходящих для участия в акции.
Неприменимо для автоакций
Authorizations:
query Parameters
promotionID required | integer Example: promotionID=1 ID акции |
inAction required | boolean Default: false Example: inAction=true Участвует в акции:
|
limit | integer <uint> [ 1 .. 1000 ] Example: limit=10 Количество запрашиваемых товаров |
offset | integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные |
Responses
Response samples
- 200
- 400
- 401
- 422
- 429
{- "data": {
- "nomenclatures": [
- {
- "id": 162579635,
- "inAction": true,
- "price": 1500,
- "currencyCode": "RUB",
- "planPrice": 1000,
- "discount": 15,
- "planDiscount": 34
}
]
}
}
Добавить товар в акцию{{ /api/v1/calendar/promotions/upload }}
Создаёт загрузку товара в акцию.
Состояние загрузки можно проверить с помощью отдельных методов.
Неприменимо для автоакций
Authorizations:
Request Body schema: application/jsonrequired
object |
Responses
Request samples
- Payload
{- "data": {
- "promotionID": 1,
- "uploadNow": true,
- "nomenclatures": [
- 1,
- 3,
- 642
]
}
}
Response samples
- 200
- 400
- 401
- 422
- 429
{- "data": {
- "alreadyExists": false,
- "uploadID": 11
}
}
Списки кампаний{{ /adv/v1/promotion/count }}
Возвращает списки кампаний, сгруппированных по типу и статусу, с информацией о дате последнего изменения кампании
Authorizations:
Responses
Response samples
- 200
- 401
- 429
{- "adverts": [
- {
- "type": 4,
- "status": 8,
- "count": 3,
- "advert_list": [
- {
- "advertId": 6485174,
- "changeTime": "2023-05-10T12:12:52.676254+03:00"
}, - {
- "advertId": 6500443,
- "changeTime": "2023-05-10T17:08:46.370656+03:00"
}, - {
- "advertId": 7936341,
- "changeTime": "2023-07-12T15:51:08.367478+03:00"
}
]
}
], - "all": 3
}
Информация о кампаниях{{ /adv/v1/promotion/adverts }}
Возвращает получать информацию о кампаниях по query-параметрам либо по списку ID кампаний
Authorizations:
query Parameters
status | integer Enum: -1 4 7 8 9 11
|
type | integer Enum: 4 5 6 7 8 9
|
order | string Enum: "create" "change" "id"
|
direction | string Enum: "desc" "asc"
Например: /adv/v1/promotion/adverts?type=6&order=change&direction=asc
|
Request Body schema: application/jsonrequired
Список ID кампаний. Максимум 50.
Получить id кампаний можно методом Списки кампаний.
Responses
Request samples
- Payload
[- 1234567,
- 63453471
]
Response samples
- 200
- 400
- 401
- 422
- 429
[- {
- "endTime": "2100-01-01 00:00:00+03:00",
- "createTime": "2023-05-31 16:57:42.654141+03:00",
- "changeTime": "2023-06-21 22:10:43.074183+03:00",
- "startTime": "2023-07-21 21:17:42.872376+03:00",
- "name": "Носки_Шерстяные",
- "params": [
- {
- "intervals": [
- {
- "begin": 3,
- "end": 5
}
], - "price": 400,
- "subjectId": 201,
- "subjectName": "Носки",
- "nms": [
- {
- "nm": 11111111,
- "active": true
}
], - "active": false
}
], - "dailyBudget": 0,
- "advertId": 12345,
- "status": 9,
- "type": 6,
- "paymentType": "cpm",
- "searchPluseState": false
}
]
Создать автоматическую кампанию{{ /adv/v1/save-ad }}
Создаёт автоматическую кампанию
Authorizations:
Request Body schema: application/jsonrequired
type | integer
|
name | string Название кампании (max. 128 символов) |
subjectId | integer ID предмета, для которого создается кампания. |
sum | integer Сумма пополнения |
btype | integer
|
on_pause | boolean
|
nms | Array of integers Массив артикулов WB. |
cpm | integer Ставка. |
Responses
Request samples
- Payload
{- "type": 8,
- "name": "Парашюты",
- "subjectId": 270,
- "sum": 500,
- "btype": 1,
- "on_pause": true,
- "nms": [
- 9178363,
- 9178364
], - "cpm": 10
}
Response samples
- 200
- 400
- 401
- 422
- 429
9008917
Создать кампанию Аукцион{{ /adv/v2/seacat/save-ad }}
Создаёт кампанию Аукцион
Authorizations:
Request Body schema: application/json
campaignName | string Название кампании |
nms | Array of integers Номенклатуры для кампании. Доступные номенклатуры можно получить с помощью метода Номенклатуры для кампаний. Максимум 50 товаров ( |
Responses
Request samples
- Payload
{- "name": "Телефоны",
- "nms": [
- 146168367,
- 200425104
]
}
Response samples
- 400
- 401
- 429
Нет доступных категорий для рк. Создайте новую кампанию для попадания в текущие категории
Предметы для кампаний{{ /adv/v1/supplier/subjects }}
Возвращает предметы и номенклатуры, которые можно добавить в кампании
Authorizations:
Responses
Response samples
- 200
- 401
- 429
[- {
- "name": "3D очки",
- "id": 2560,
- "count": 1899
}
]
Номенклатуры для кампаний{{ /adv/v2/supplier/nms }}
Возвращает номенклатуры, которые можно добавить в кампании
Authorizations:
Request Body schema: application/json
ID предметов, для которых нужно получить номенклатуры
Responses
Request samples
- Payload
[- 123,
- 456,
- 765,
- 321
]
Response samples
- 200
- 400
- 401
- 429
[- {
- "title": "Плед",
- "nm": 146168367,
- "subjectId": 765
}
]
Изменение ставки у кампании{{ /adv/v0/cpm }}
Меняет ставку у кампании.
Изменённая ставка появится в информации о кампании в течение трёх минут.
422
— размер ставки не изменён.
При изменении ставки для кампании с типом 9
— Аукцион:
- Значение
type
всегда будет9
- Значение
instrument
всегда будет6
(устаревший тип кампании). - Значение
param
всегда берётся из поляid
структурыsubject
в информации о кампании.
Authorizations:
Request Body schema: application/jsonrequired
advertId required | integer ID кампании, где меняется ставка |
type required | integer Enum: 5 6 7 8 9
|
cpm required | integer Новое значение ставки |
param required | integer Параметр, для которого будет внесено изменение. Является значением |
instrument | integer тип кампании для изменения ставки в 4 - каталог (устаревший тип), 6 - поиск (устаревший тип) |
Responses
Request samples
- Payload
{- "advertId": 789,
- "type": 5,
- "cpm": 456,
- "param": 23,
- "instrument": 4
}
Response samples
- 400
- 401
- 422
- 429
Некорректное значение параметра param
Удаление кампании{{ /adv/v0/delete }}
Удаляет кампании в статусе 4
— готова к запуску.
После удаления кампания некоторое время будет находиться в статусе -1
.
Полное удаление кампании занимает от 3 до 10 минут
Authorizations:
query Parameters
id required | integer ID кампании |
Responses
Response samples
- 400
- 401
- 429
Некорректный ID кампании
{- "error": "Некорректный ID кампании"
}
Переименование кампании{{ /adv/v0/rename }}
Меняет название кампании
Authorizations:
Request Body schema: application/json
advertId required | integer ID кампании, у которой меняется название |
name required | string Новое название (максимум 100 символов) |
Responses
Request samples
- Payload
{- "advertId": 2233344,
- "name": "newnmame"
}
Response samples
- 400
- 401
- 422
- 429
Некорректный ID РК
Запуск кампании{{ /adv/v0/start }}
Запускает кампании в статусах 4
— одобрено или 11
— пауза по расходу бюджета.
Чтобы запустить кампанию со статусом 4
, необходимо выполнить два условия:
- После создания кампании в кабинете WB. Продвижение нажать кнопку Применить изменения.
- Установить бюджет.
Чтобы запустить кампанию со статусом 11
, необходимо пополнить её бюджет
Authorizations:
query Parameters
id required | integer Example: id=1234 ID кампании |
Responses
Response samples
- 400
- 401
- 422
- 429
Некорректный ID РК
Пауза кампании{{ /adv/v0/pause }}
Ставит кампании в статусе 9
— идут показы — на паузу
Authorizations:
query Parameters
id required | integer Example: id=1234 ID кампании |
Responses
Response samples
- 400
- 401
- 422
- 429
Некорректный ID РК
Завершение кампании{{ /adv/v0/stop }}
Завершает кампании статусах:
4
— одобрено9
— приостановлена продавцом11
— пауза по расходу бюджета
Authorizations:
query Parameters
id required | integer Example: id=1234 ID кампании |
Responses
Response samples
- 400
- 401
- 422
- 429
Некорректный ID РК
Бюджет кампании{{ /adv/v1/budget }}
Возвращает информацию о бюджете кампании
Authorizations:
query Parameters
id required | integer Example: id=1 ID кампании |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "cash": 0,
- "netting": 0,
- "total": 500
}
Пополнение бюджета кампании{{ /adv/v1/budget/deposit }}
Пополняет бюджет кампании
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
Request Body schema: application/jsonrequired
sum | integer Сумма пополнения (min. 500 ₽) |
type | integer
|
return | boolean Флаг возврата ответа ( |
Responses
Request samples
- Payload
{- "sum": 500,
- "type": 1,
- "return": true
}
Response samples
- 200
- 400
- 401
- 429
Ответ при return=true
{- "total": 500
}
Управление активностью фиксированных фраз{{ /adv/v1/search/set-plus }}
Меняет активность фиксированных фраз. Только для кампаний типа Аукцион
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
fixed | boolean Новое состояние ( |
Responses
Response samples
- 401
- 429
{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}
Установка/удаление фиксированных фраз{{ /adv/v1/search/set-plus }}
Устанавливает и удаляет фиксированные фразы. Только для кампаний типа Аукцион.
Отправка пустого массива удаляет все фиксированные фразы и отключает активность фиксированных фраз в кампании
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
Request Body schema: application/jsonrequired
pluse | Array of strings Список фиксированных фраз (max. 100) |
Responses
Request samples
- Payload
{- "pluse": [
- "Фраза 1",
- "Фраза 2"
]
}
Response samples
- 200
- 401
- 429
[ "Фраза 1", "Фраза 2" ]
Установка/удаление минус-фраз фразового соответствия{{ /adv/v1/search/set-phrase }}
Устанавливает и удаляет минус-фразы фразового соответствия. Только для кампаний типа Аукцион.
Максимально допустимое количество минус-фраз в кампании — 1000.
Отправка пустого массива удаляет все минус-фразы фразового соответствия из кампании
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
Request Body schema: application/jsonrequired
phrase | Array of strings Минус-фразы (макс. 1000 шт.) |
Responses
Request samples
- Payload
{- "phrase": [
- "сло",
- "гу"
]
}
Response samples
- 401
- 429
{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}
Установка/удаление минус-фраз точного соответствия{{ /adv/v1/search/set-strong }}
Устанавливает и удаляет минус-фразы точного соответствия. Только для кампаний типа Аукцион.
Максимально допустимое количество минус-фраз в кампании — 1000.
Отправка пустого массива удаляет все минус-фразы точного соответствия из кампании
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
Request Body schema: application/jsonrequired
strong | Array of strings Минус-фразы (макс. 1000 шт.) |
Responses
Request samples
- Payload
{- "strong": [
- "стоять",
- "лопата"
]
}
Response samples
- 401
- 429
{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}
Установка/удаление минус-фраз из поиска{{ /adv/v1/search/set-excluded }}
Устанавливает и удаляет минус-фразы из поиска. Только для кампаний типа Аукцион.
Максимально допустимое количество минус-фраз в кампании — 1000.
Отправка пустого массива удаляет все минус-фразы из поиска из кампании
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
Request Body schema: application/jsonrequired
excluded | Array of strings Минус-фразы (макс. 1000 шт.) |
Responses
Request samples
- Payload
{- "excluded": [
- "что-то синее",
- "картошечка"
]
}
Response samples
- 401
- 429
{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}
Установка/удаление минус-фраз для автоматической кампании{{ /adv/v1/auto/set-excluded }}
Устанавливает или удаляет минус-фразы.
Отправка пустого массива удаляет все минус-фразы из кампании
Authorizations:
query Parameters
id required | integer Example: id=1234567 ID кампании |
Request Body schema: application/jsonrequired
excluded | Array of strings Список фраз (макс. 1000 шт.) |
Responses
Request samples
- Payload
Установка минус-фраз
{- "excluded": [
- "первая фраза",
- "вторая фраза"
]
}
Response samples
- 401
- 429
{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}
Список номенклатур для автоматической кампании{{ /adv/v1/auto/getnmtoadd }}
Возвращает список номенклатур, доступных для добавления в кампанию
Authorizations:
query Parameters
id required | integer Example: id=1 ID кампании |
Responses
Response samples
- 200
- 401
- 429
[ 1111111111, 2222222222, 3333333333, 4444444444 ]
Изменение списка номенклатур в автоматической кампании{{ /adv/v1/auto/updatenm }}
Добавляет и удаляет номенклатуры в автоматической кампании.
Удалить единственную номенклатуру из кампании нельзя.
Проверки по параметру delete
не предусмотрено.
Если пришел ответ со статус-кодом 200
, а изменений не произошло, проверьте запрос на соответствие документации
Authorizations:
query Parameters
id required | integer Example: id=1 ID кампании |
Request Body schema: application/jsonrequired
add | Array of integers Номенклатуры, которые необходимо добавить. |
delete | Array of integers Номенклатуры, которые необходимо удалить. |
Responses
Request samples
- Payload
{- "add": [
- 11111111,
- 44444444
], - "delete": [
- 55555555
]
}
Response samples
- 400
- 401
- 429
{- "error": "кампания не найдена"
}
Количество медиакампаний{{ /adv/v1/count }}
Возвращает количество медиакампаний продавца
Authorizations:
Responses
Response samples
- 200
- 401
- 429
{- "all": 6,
- "adverts": [
- {
- "type": 2,
- "status": 7,
- "count": 2
}, - {
- "type": 2,
- "status": 8,
- "count": 4
}
]
}
Список медиакампаний{{ /adv/v1/adverts }}
Возвращает список медиакампаний продавца
Authorizations:
query Parameters
status | integer Example: status=1
|
type | integer Example: type=1
|
limit | integer Example: limit=1 Количество кампаний в ответе |
offset | integer Example: offset=1 Смещение относительно первой медиакампании |
order | string Example: order=id
|
direction | string Example: direction=desc
|
Responses
Response samples
- 200
- 401
- 429
[- {
- "advertId": 123456,
- "name": "тост",
- "brand": "goosb",
- "type": 2,
- "status": 8,
- "createTime": "2023-03-25T20:35:57.116943+03:00"
}, - {
- "advertId": 54321,
- "name": "тест",
- "brand": "bobr",
- "type": 1,
- "status": 7,
- "createTime": "2023-07-24T16:48:20.935599+03:00",
- "endTime": "2023-07-25T20:35:50.104978Z"
}
]
Информация о медиакампании{{ /adv/v1/advert }}
Возвращает информацию об одной медиакампании
Authorizations:
query Parameters
id required | integer Example: id=23569 ID медиакампании |
Responses
Response samples
- 200
- 401
- 429
{- "advertId": 23569,
- "name": "Реклама денег принеси",
- "brand": "Plank",
- "type": 2,
- "status": 11,
- "createTime": "2023-07-19T11:13:41.195138+03:00",
- "extended": {
- "reason": "Для возобновления показов пополните бюджет медиакампании",
- "expenses": 10000,
- "from": "2023-07-19T12:05:35.847348Z",
- "to": "2123-07-20T08:14:13.079176+03:00",
- "updated_at": "2023-07-21T13:25:31.129766+03:00",
- "price": 0,
- "budget": 0,
- "operation": 1,
- "contract_id": 0
}, - "items": [
- {
- "id": 68080,
- "name": "Унисон",
- "status": 7,
- "place": 2,
- "budget": 650000,
- "daily_limit": 500,
- "category_name": "Главная",
- "cpm": 351,
- "advert_type": 1,
- "created_at": "2023-11-01T15:40:46.86165+03:00",
- "updated_at": "2023-11-08T23:44:33.248229+03:00",
- "date_from": "2023-11-01T16:05:22.286002Z",
- "date_to": "2023-11-09T17:27:32.745869+03:00",
- "nms": [
- 123456,
- 11111111
], - "bottomText1": "string",
- "bottomText2": "string",
- "message": "string",
- "additionalSettings": 1,
- "receiversCount": 1,
- "subject_id": 6945,
- "subject_name": "Бельё",
- "action_name": "Распродажа! Создай себе домашний уют!",
- "show_hours": [
- {
- "From": 7,
- "To": 8
}
], - "Erid": "string"
}
]
}
Изменение ставки баннера{{ /adv/v1/item/cpm/change }}
Меняет ставку баннера в структуре items
.
Изменить кампанию можно только в одном из статусов:
4
— одобрено5
— запланировано6
— на показах9
— приостановлена продавцом10
— пауза по дневному лимиту11
— пауза по расходу бюджета
Authorizations:
Request Body schema: application/jsonrequired
advert_id required | integer ID медиакампании |
item_id required | integer ID баннера |
cpm required | string Новая ставка |
Responses
Request samples
- Payload
{- "advert_id": 80474,
- "item_id": 41573,
- "cpm": 300
}
Response samples
- 400
- 401
- 404
- 429
"Ошибка получения айтемов: {x}", Детали ошибки
Запуск медиакампании{{ /adv/v1/advert/start }}
Запускает приостановленные медиакампании.
После запуска кампания в течение 2-5 минут будет находиться в статусе 4
— одобрено. Затем статус будет изменён на актуальный, в зависимости от конфигурации медиакампании.
Статусы, в которых для медиакампании доступен запуск:
9
— приостановлена продавцом11
— пауза по расходу бюджета
Authorizations:
Request Body schema: application/jsonrequired
advert_id required | integer ID медиакампании |
reason | string Описание причины запуска |
Responses
Request samples
- Payload
{- "advert_id": 123456,
- "reason": "Причина запуска"
}
Response samples
- 400
- 401
- 404
- 429
Кампания не найдена
Приостановка медиакампании{{ /adv/v1/advert/pause }}
Приостанавливает медиакампании и переводит в статус 9
— приостановлена продавцом.
Статусы, в которых для медиакампании доступна приостановка:
4
— одобрено5
— запланировано6
— на показах10
— пауза по дневному лимиту11
— пауза по расходу бюджета
Authorizations:
Request Body schema: application/jsonrequired
advert_id required | integer ID медиакампании |
reason | string Описание причины приостановки |
Responses
Request samples
- Payload
{- "advert_id": 123456,
- "reason": "Описание причины приостановки"
}
Response samples
- 401
- 404
- 429
{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}
Завершение медиакампании{{ /adv/v1/advert/stop }}
Завершает медиакампанию и переводит её в статус 7
— завершено.
Статусы, в которых медиакампании можно завершить:
1
— черновик3
— отклонено с возможностью вернуть на модерацию4
— одобрено5
— запланировано6
— на показах8
— отказался9
— приостановлена продавцом10
— пауза по дневному лимиту11
— пауза по расходу бюджета
Authorizations:
Request Body schema: application/jsonrequired
advert_id required | integer ID медиакампании |
reason | string Описание причины завершения |
Responses
Request samples
- Payload
{- "advert_id": 123456,
- "reason": "Описание причины завершения"
}
Response samples
- 400
- 401
- 404
- 429
Перевод в новый статус невозможен