### GET /adv/v0/pause Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод ставит [кампании](/openapi/promotion#tag/Kampanii/paths/~1api~1advert~1v2~1adverts/get) в статусе `9` — активна — на паузу.
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 5 запросов | 200 мс | 5 запросов |
```markdown ### Parameters - **id** (integer, query, required): ID кампании (example: 1234) ### Responses #### 200 - Успешно Empty response body #### 400 - Неправильный запрос **400Response** - **error** (string) #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 422 - Статус не изменен #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v0/pause?id=1234" ``` ``` -------------------------------- ### GET /adv/v1/budget Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод возвращает информацию о бюджете [кампании](/openapi/promotion#tag/Kampanii/paths/~1api~1advert~1v2~1adverts/get) — максимальной сумме затрат на кампанию. Бюджет кампании можно [пополнить](/openapi/promotion#tag/Finansy/paths/~1adv~1v1~1budget~1deposit/post).
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 4 запроса | 250 мс | 4 запроса |
```markdown ### Parameters - **id** (integer, query, required): ID кампании (example: 1) ### Responses #### 200 - Успешно - **cash** (integer): Поле не используется. Значение всегда 0. - **netting** (integer): Поле не используется. Значение всегда 0. - **total** (integer): Бюджет кампании, ₽ #### 400 - Неправильный запрос #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v1/budget?id=1" ``` ``` -------------------------------- ### GET /adv/v0/start Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод запускает [кампании](/openapi/promotion#tag/Kampanii/paths/~1api~1advert~1v2~1adverts/get) в статусах `4` — готово к запуску — или `11` — пауза. Чтобы запустить кампанию, проверьте ее бюджет. Если бюджета недостаточно, [пополните его](/openapi/promotion#tag/Finansy/paths/~1adv~1v1~1budget~1deposit/post).
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 5 запросов | 200 мс | 5 запросов |
```markdown ### Parameters - **id** (integer, query, required): ID кампании (example: 1234) ### Responses #### 200 - Успешно Empty response body #### 400 - Неправильный запрос **400Response** - **error** (string) #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 422 - Статус не изменен #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v0/start?id=1234" ``` ``` -------------------------------- ### GET /adv/v1/upd Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод формирует список фактических затрат на рекламные кампании за заданный период.
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 1 запрос | 1 сек | 5 запросов |
```markdown ### Parameters - **from** (string (date), query, required): Начало интервала (example: "2023-07-31") - **to** (string (date), query, required): Конец интервала.
(Минимальный интервал 1 день, максимальный 31) (example: "2023-08-02") ### Responses #### 200 - Успешно - Array of object - **updNum** (integer): Номер выставленного документа - **updTime** (string (time-date)): Время списания - **updSum** (integer): Выставленная сумма - **advertId** (integer): ID кампании - **campName** (string): Название кампании - **advertType** (integer): Тип кампании - **paymentType** (string): Источник списания: - `Баланс` - `Бонусы` - `Счёт` - `Кэшбэк` - **advertStatus** (integer): Статус кампании: - `-1` — удалена, процесс удаления будет завершён в течение 10 минут - `4` — готова к запуску - `7` — завершена - `8` — отменена - `9` — активна - `11` — на паузе #### 400 - Неправильный запрос #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v1/upd?from=2023-07-31&to=2023-08-02" ``` ``` -------------------------------- ### GET /adv/v0/delete Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод удаляет [кампании](/openapi/promotion#tag/Kampanii/paths/~1api~1advert~1v2~1adverts/get) в статусе `4` — готова к запуску.

После удаления кампания некоторое время будет находиться в статусе `-1` — кампания в процессе удаления. Полное удаление кампании занимает от 3 до 10 минут.
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 5 запросов | 200 мс | 5 запросов |
```markdown ### Parameters - **id** (integer, query, required): ID кампании ### Responses #### 200 - Успешно Empty response body #### 400 - Неправильный запрос **responseAdvError1** - **error** (string) #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v0/delete?id=0" ``` ``` -------------------------------- ### GET /adv/v1/supplier/subjects Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод возвращает список [предметов](/openapi/work-with-products#tag/Kategorii-predmety-i-harakteristiki/paths/~1content~1v2~1object~1all/get), которые можно добавить в рекламную [кампанию](/openapi/promotion#tag/Kampanii/paths/~1api~1advert~1v2~1adverts/get).
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 12 сек | 1 запрос | 12 сек | 5 запросов |
```markdown ### Parameters - **payment_type** (string, query, optional): Тип оплаты: - `cpm` — за показы - `cpc` — за клик ### Responses #### 200 - Успешно - Array of object - **id** (integer): ID предмета - **name** (string): Предмет - **count** (integer): Количество Артикулов WB (`nmId`) с таким предметом. #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 404 - Не найдено Не найдено #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v1/supplier/subjects?payment_type=cpm" ``` ``` -------------------------------- ### GET /api/v1/calendar/promotions/nomenclatures Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод формирует список товаров, подходящих для участия в [акции](/openapi/promotion#tag/Kalendar-akcij/paths/~1api~1v1~1calendar~1promotions~1details/get). Эти товары можно добавить в акцию с помощью [отдельного метода](/openapi/promotion#tag/Kalendar-akcij/paths/~1api~1v1~1calendar~1promotions~1upload/post).
Данный метод неприменим для автоакций.
Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 6 сек | 10 запросов | 600 мс | 5 запросов |
```markdown ### Parameters - **promotionID** (integer, query, required): ID акции (example: 1) - **inAction** (boolean, query, required): Участвует в акции: - `true` — да - `false` — нет (example: true) - **limit** (integer, query, optional): Количество запрашиваемых товаров (example: 10) - **offset** (integer, query, optional): После какого элемента выдавать данные (example: 0) ### Responses #### 200 - response - **data** (object): Данные ответа - **nomenclatures** (array (PromotionsGoodsList)): Список товаров Array items: - **id** (integer): Артикул WB (example: 162579635) - **inAction** (boolean): Участвует в акции: - `true` — да - `false` — нет (example: true) - **price** (number (float)): Текущая розничная цена (example: 1500) - **currencyCode** (string): Валюта в формате ISO 4217 (example: "RUB") - **planPrice** (number (float)): Плановая цена (цена во время акции) (example: 1000) - **discount** (integer): Текущая скидка (example: 15) - **planDiscount** (integer): Рекомендуемая скидка для участия в акции (example: 34) #### 400 - response - **errorText** (string): Текст ошибки (example: "Invalid query params") #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 422 - response - **errorText** (string): Текст ошибки #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v1/calendar/promotions/nomenclatures?promotionID=1&inAction=true&limit=10&offset=0" ``` ``` -------------------------------- ### GET /adv/v1/balance Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод возвращает информацию о: - счёте кабинета Продвижения WB. Его пополняет продавец. - балансе — максимальной сумме для оплаты кампании по взаиморасчету: удержании средств из будущих продаж. Баланс пополнить нельзя, он рассчитывается автоматически на основе отчётов по продвижению. - бонусных начислениях WB. Информацию о бюджете кампаний можно получить в [отдельном методе](/openapi/promotion#tag/Finansy/paths/~1adv~1v1~1budget/get).
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 1 запрос | 1 сек | 5 запросов |
```markdown ### Responses #### 200 - Успешно - **balance** (integer): Счёт, ₽ - **net** (integer): Баланс, ₽ - **bonus** (integer): Бонусы, ₽ - **cashbacks** (array (object)): Промо-бонусы Array items: - **sum** (integer): Промо-бонусы, ₽ - **percent** (integer): Процент от суммы пополнения бюджета кампании, который можно оплатить промо-бонусами за один раз - **expiration_date** (string (ISO 8601)): Дата окончания действия промо-бонусов #### 400 - Неправильный запрос #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v1/balance" ``` ``` -------------------------------- ### GET /api/v1/calendar/promotions/details Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод возвращает подробную информацию об [акции](/openapi/promotion#tag/Kalendar-akcij/paths/~1api~1v1~1calendar~1promotions~1details/get) по ID.
Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 6 сек | 10 запросов | 600 мс | 5 запросов |
```markdown ### Parameters - **promotionIDs** (array (integer), query, required): ID акций, по которым нужно вернуть информацию (example: [1,3,64]) ### Responses #### 200 - response - **data** (object): Данные ответа - **promotions** (array (object)): Список акций Array items: - **id** (integer): ID акции (example: 123) - **name** (string): Название акции (example: "ХИТЫ ГОДА") - **description** (string): Описание акции (example: "В акции принимают участие самые популярные товары 2023 года. Карточки товаров будут выделены плашкой «ХИТ ГОДА», чтобы покупатели замечали эти товары среди других. Также они будут размещены под баннерами на главной странице и примут участие в PUSH-уведомлениях. С ценами для вступления в акцию вы можете ознакомиться ниже.") - **advantages** (array (string)): Преимущества акции (example: ["Плашка","Баннер","Топ выдачи товаров"]) - **startDateTime** (string): Начало акции (example: "2023-06-05T21:00:00Z") - **endDateTime** (string): Конец акции (example: "2023-06-05T21:00:00Z") - **inPromoActionLeftovers** (integer): Количество товаров с остатками, участвующих в акции (example: 45) - **inPromoActionTotal** (integer): Общее количество товаров, участвующих в акции (example: 123) - **notInPromoActionLeftovers** (integer): Количество товаров с остатками, не участвующих в акции (example: 3) - **notInPromoActionTotal** (integer): Общее количество товаров, не участвующих в акции (example: 10) - **participationPercentage** (integer): Уже участвующие в акции товары, %. Рассчитывается по товарам в акции и с остатком (example: 10) - **type** (string (regular|auto)): Тип акции: - `regular` — акция - `auto` — автоакция (example: "auto") ("regular"|"auto") - **exceptionProductsCount** (integer): Количество товаров, исключенных из автоакции до её старта. Только при `"type": "auto"`.
В момент старта акции эти товары автоматически будут без скидки (example: 10) - **ranging** (array (object)): Ранжирование (если подключено) (example: [{"condition":"productsInPromotion","participationRate":10,"boost":7},{"condition":"calculateProducts","participationRate":20,"boost":17},{"condition":"allProducts","participationRate":35,"boost":30}]) Array items: - **condition** (string): Тип [ранжирования](https://seller.wildberries.ru/help-center/article/A-385): - `productsInPromotion` — продвижение получат товары продавца, участвующие в акции - `calculateProducts` — продвижение получат любые товара продавца, предложенные к участию в акции - `allProducts` — продвижение получат все товары продавца - **participationRate** (integer): Количество товаров продавца для перехода на следующий уровень ранжирования, % - **boost** (integer): Текущий уровень поднятия в поиске, % #### 400 - response - **errorText** (string): Текст ошибки (example: "Failed to parse data") #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v1/calendar/promotions/details?promotionIDs=1,3,64" ``` ``` -------------------------------- ### GET /adv/v3/fullstats Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод формирует статистику для кампаний независимо от типа.

Максимальный период в запросе — 31 день.

Для кампаний в статусах `7`, `9` и `11`.
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 мин | 3 запроса | 20 сек | 1 запрос |
```markdown ### Parameters - **ids** (string, query, required): ID кампаний, максимум 50 значений (example: "22161678,28449281,28155229") - **beginDate** (string (date), query, required): Дата начала интервала - **endDate** (string (date), query, required): Дата окончания интервала ### Responses #### 200 - Успешно **ResponseFullStats** - Array of FullStatsItem #### 400 - Неправильный запрос **FullStatsError** - **detail** (string) (required): Детали ошибки - **origin** (string) (required): ID внутреннего сервиса WB - **request_id** (string) (required): ID запроса - **status** (integer) (required): HTTP статус-код - **title** (string) (required): Заголовок ошибки #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v3/fullstats?ids=22161678,28449281,28155229&beginDate=2023-01-01&endDate=2023-01-01" ``` ``` -------------------------------- ### GET /adv/v0/stop Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод завершает [кампании](/openapi/promotion#tag/Kampanii/paths/~1api~1advert~1v2~1adverts/get) в статусах: - `4` — готово к запуску - `9` — активна - `11` — пауза
Лимит запросов на один аккаунт продавца: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 1 сек | 5 запросов | 200 мс | 5 запросов |
```markdown ### Parameters - **id** (integer, query, required): ID кампании (example: 1234) ### Responses #### 200 - Успешно Empty response body #### 400 - Неправильный запрос **400Response** - **error** (string) #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 422 - Статус не изменен #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/adv/v0/stop?id=1234" ``` ``` -------------------------------- ### GET /api/v1/calendar/promotions Source: https://dev.wildberries.ru/api/swagger/yaml/ru/08-promotion.yaml Метод возвращает список [акций](/openapi/promotion#tag/Kalendar-akcij/paths/~1api~1v1~1calendar~1promotions~1details/get) в WB с датами и временем проведения.
Лимит запросов на один аккаунт продавца для всех методов категории Календарь акций: | Период | Лимит | Интервал | Всплеск | | --- | --- | --- | --- | | 6 сек | 10 запросов | 600 мс | 5 запросов |
```markdown ### Parameters - **startDateTime** (string (date-time), query, required): Начало периода, формат `YYYY-MM-DDTHH:MM:SSZ` (example: "2023-09-01T00:00:00Z") - **endDateTime** (string (date-time), query, required): Конец периода, формат `YYYY-MM-DDTHH:MM:SSZ` (example: "2024-08-01T23:59:59Z") - **allPromo** (boolean, query, required): Показать акции: - `false` — доступные для участия - `true` — все акции - **limit** (integer, query, optional): Количество запрашиваемых акций (example: 10) - **offset** (integer, query, optional): После какого элемента выдавать данные (example: 0) ### Responses #### 200 - response - **data** (object): Данные ответа - **promotions** (array (object)): Список акций Array items: - **id** (integer): ID акции (example: 123) - **name** (string): Название акции (example: "скидки") - **startDateTime** (string (date-time)): Начало акции (example: "2023-06-05T21:00:00Z") - **endDateTime** (string (date-time)): Конец акции (example: "2023-06-05T21:00:00Z") - **type** (string (regular|auto)): Тип акции: - `regular` — акция - `auto` — автоакция ("regular"|"auto") #### 400 - response - **errorText** (string): Текст ошибки (example: "Failed to parse data") #### 401 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса #### 402 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки. Ошибка возвращается только сервисам из [Каталога решений для бизнеса](https://dev.wildberries.ru/business-solutions) #### 429 - response - **title** (string): Заголовок ошибки - **detail** (string): Детали ошибки - **code** (string): Внутренний код ошибки - **requestId** (string): Уникальный ID запроса - **origin** (string): ID внутреннего сервиса WB - **status** (number): HTTP статус-код - **statusText** (string): Расшифровка HTTP статус-кода - **timestamp** (string (date-time)): Дата и время запроса ### Example Usage ```bash curl -X GET "https://api.example.com/api/v1/calendar/promotions?startDateTime=2023-09-01T00:00:00Z&endDateTime=2024-08-01T23:59:59Z&allPromo=false&limit=10&offset=0" ``` ```