для разработчиков На сайт Rentu

Зоны подсчёта

Справочник зон. Отсюда берётся zone_id для посещаемости, и это единственное числовое поле id в API.

GET /api/external/v2/sc/{sc_id}/traffic_areas   BASIC

Параметров, кроме sc_id в пути, нет. Пагинации нет. Сортировка по названию.

Ответ#

ПолеТипОписание
idintegerИдентификатор зоны. Передаётся как zone_id в посещаемость
titlestringНазвание зоны
descriptionstring | nullОписание
traffic_typestringТип зоны, см. ниже
shop_idsarray of stringТорговые точки, попадающие в зону

id здесь целое число, а не строка, в отличие от всех остальных идентификаторов API. Зоны подсчёта живут в отдельном хранилище. Если парсер на стороне интеграции приводит все id к строке, при передаче в zone_id это ломает запрос.

Типы зон#

ЗначениеЧто считает
shopping_centerВесь торговый центр
sell_locationОтдельную торговую точку
passageПроход, вход, коридор
food_courtФудкорт
floorЭтаж
sectorСектор
floor_sectorСектор на этаже
absentЗона заведена, но оборудование не установлено

Служебные зоны офисов арендаторов в выдачу не попадают.

json
{
  "success": true,
  "data": [
    {
      "id": 4271,
      "title": "Главный вход",
      "description": "Северный вход, 4 турникета",
      "traffic_type": "passage",
      "shop_ids": [
        "6512a2000000000000000101"
      ]
    }
  ]
}

Ошибки#

КодHTTPКогда
traffic_not_configured404В центре не настроена система подсчёта посещаемости. Повторять бесполезно — нужно подключение оборудования