Торговые центры

GET /api/external/v2/shopping_centers BASIC

Возвращает торговые центры, в которых у владельца ключа есть роль. Отсортировано по названию. Параметров нет, пагинации нет: у одного человека центров единицы.

bash

curl https://api.rentu.ru/api/external/v2/shopping_centers \
  -H 'Authorization: Bearer YOUR_TOKEN'

Ответ#

Поле	Тип	Описание
`id`	string	Идентификатор центра. Это и есть `sc_id` в остальных запросах
`title`	string	Название
`prefix`	string	Короткий префикс центра
`address`	string	Адрес
`phone`	string	Телефон
`time_zone`	string	Таймзона центра в формате IANA. В ней считаются границы суток
`rent_area_size`	number	Арендопригодная площадь, м²
`total_area_size`	number	Общая площадь, м²
`expected_quantity`	integer	Плановое количество торговых точек
`external_id`	string	Идентификатор центра во внешней системе, если он был передан нам
`city`	object	`{ id, name, time_zone }`

json

{
  "success": true,
  "data": [
    {
      "id": "6512a1f0b3c4d5e6f7a8b901",
      "title": "ТЦ Галерея",
      "prefix": "GAL",
      "address": "Москва, Ленинский пр-т, 1",
      "phone": "+74951234567",
      "time_zone": "Europe/Moscow",
      "rent_area_size": 24500.0,
      "total_area_size": 41000.0,
      "expected_quantity": 180,
      "external_id": "MALL-001",
      "city": {
        "id": "6512a1f0b3c4d5e6f7a8b900",
        "name": "Москва",
        "time_zone": "Europe/Moscow"
      }
    }
  ]
}

Поведение, о котором стоит знать#

Список динамический. Он не хранится на ключе, а спрашивается на каждом запросе. Дали сотруднику роль в новом центре, и тот появится здесь сразу. Сняли роль, и центр исчезнет в течение часа.

Заблокированный центр остаётся в списке. Если у центра ограничение по оплате, он всё равно виден здесь, но запросы его данных вернут 402. Так различаются «центра нет» и «центр есть, но данные закрыты».

Пустой список приходит с 200. Если у сотрудника нет ролей нигде, придёт {"success": true, "data": []}, а не ошибка.

Ошибки#

Код	HTTP	Когда
`rights_unavailable`	503	Сервис прав не ответил. Запрос стоит повторить с задержкой — пустой список вместо ошибки мы не отдаём намеренно, чтобы сбой не был принят за отсутствие доступа