События ТЦ · Rentu API

POST /api/external/v2/sc/{sc_id}/events BASIC

Параметры#

Имя	Тип	Обяз.	По умолчанию	Описание
`sc_id`	string, в пути	да	—	Идентификатор центра
`name`	string	да	—	Название события
`description`	string	да	—	Описание
`event_type`	string	да	—	`calendar`, `marketing` или `other`
`start_date`	date	да	—	`YYYY-MM-DD`
`end_date`	date	да	—	`YYYY-MM-DD`, не раньше `start_date`
`color`	string	нет	`#EAEAEA`	Цвет в календаре, строго `#RRGGBB`
`shop_ids`	array of string	нет	`[]`	Точки, которых касается событие

color принимается только в виде #RRGGBB. rgb(255,136,0), red и FF8800 без решётки дадут 422.

Служебные типы платформы system и weekend снаружи не принимаются, их ставит сама платформа.

shop_ids должны принадлежать этому центру. Повторы в списке допустимы и схлопываются.

bash

curl -X POST "https://api.rentu.ru/api/external/v2/sc/$SC/events" \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Чёрная пятница",
    "description": "Скидки во всём ТЦ",
    "event_type": "marketing",
    "start_date": "2026-11-27",
    "end_date": "2026-11-30",
    "color": "#FF8800",
    "shop_ids": ["6512a2000000000000000101"]
  }'

Ответ#

Статус 201 Created.

Поле	Тип	Описание
`id`	string	Идентификатор созданного события
`name`	string	Название
`description`	string \| null	Описание
`event_type`	string	Тип
`color`	string	Цвет `#RRGGBB`
`sell_location_ids`	array of string \| null	Точки события
`start_date`	string	`YYYY-MM-DD`
`end_date`	string	`YYYY-MM-DD`

json

{
  "success": true,
  "data": {
    "id": "66c1000000000000000000e1",
    "name": "Чёрная пятница",
    "description": "Скидки во всём ТЦ",
    "event_type": "marketing",
    "color": "#FF8800",
    "sell_location_ids": ["6512a2000000000000000101"],
    "start_date": "2026-11-27",
    "end_date": "2026-11-30"
  }
}

Повторная отправка#

Метод создаёт новое событие. Полный дубликат (совпали название, тип и обе даты в рамках центра) не создаётся и не подменяет существующее:

json

{
  "success": false,
  "error": {
    "code": "already_exists_in_sc",
    "message": "Название уже существует в этом торговом центре",
    "details": { "name": ["уже существует в этом торговом центре"] }
  }
}

Статус 409. При синхронизации календаря целиком его стоит трактовать как «уже создано» и продолжать: перезаливать список безопасно.

Событие с тем же названием, но другим периодом считается другим событием, 409 не будет.

Изменить или удалить событие через API нельзя. Метод один и только на создание.

Авторство#

Событие записывается от лица сотрудника, которому принадлежит ключ, — в интерфейсе центра будет видно его имя. Это ещё одна причина выдавать ключ на реального человека, см. Доступ и ключи.

Ошибки#

Код	HTTP	Когда
`already_exists_in_sc`	409	Полный дубликат по названию, типу и датам
`validation_error`	422	Неизвестный `event_type`, неверный формат `color`, чужая точка в `shop_ids`, `end_date` раньше `start_date`, пустое обязательное поле