Передача посещаемости

Методы для центров, которые считают поток своими средствами. Переданные значения читаются обратно через посещаемость наравне с данными наших счётчиков.

Суточное значение#

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

Имя	Тип	Обяз.	По умолчанию	Описание
`sc_id`	string, в пути	да	—	Идентификатор центра
`date`	date	да	—	`YYYY-MM-DD`, не в будущем
`visitors`	integer	да	—	Вошедшие за сутки
`scope`	string	нет	`sc`	`sc` — весь центр, `zone` — отдельная зона
`zone_id`	integer	при `scope=zone`	—	Идентификатор зоны из справочника

scope использует тот же словарь, что и чтение посещаемости. При scope=sc значение пишется на периметр центра, и передавать zone_id в этом случае нельзя.

Повторный вызов за те же сутки перезаписывает значение.

bash

curl -X POST "https://api.rentu.ru/api/external/v2/sc/{sc_id}/attendance" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "date": "2026-07-15", "visitors": 5000 }'

Статус 200 OK. Повторный вызов за те же сутки перезаписывает значение.

json

{
  "success": true,
  "data": {
    "date": "2026-07-15",
    "scope": "sc",
    "zone_id": null,
    "visitors": 5000
  }
}

Почасовая выгрузка со счётчика#

POST /api/external/v2/sc/{sc_id}/sensors/{external_id}/traffic BASIC

Имя	Тип	Обяз.	Описание
`sc_id`	string, в пути	да	Идентификатор центра
`external_id`	string, в пути	да	Идентификатор счётчика на стороне интеграции
`data`	array	да	До 1000 записей за вызов
`data[].datetime`	datetime	да	Начало часа, ISO 8601
`data[].in`	integer	да	Вошедшие за час
`data[].out`	integer	да	Вышедшие за час

external_id — тот идентификатор, под которым счётчик заведён при подключении. Отдельного справочника счётчиков в API нет: идентификатор принадлежит стороне, которая передаёт данные.

Повторная присылка того же часа перезаписывает значения.

bash

curl -X POST "https://api.rentu.ru/api/external/v2/sc/{sc_id}/sensors/gate-1/traffic" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [
      { "datetime": "2026-07-15T12:00:00", "in": 120, "out": 90 },
      { "datetime": "2026-07-15T13:00:00", "in": 200, "out": 180 }
    ]
  }'

Статус 200 OK. Повторная присылка того же часа перезаписывает значения.

json

{
  "success": true,
  "data": {
    "external_id": "gate-1",
    "written": 2
  }
}

Ошибки#

Код	HTTP	Когда
`traffic_not_configured`	404	В центре не настроена система подсчёта
`not_found`	404	Зоны или счётчика нет в этом центре
`validation_error`	422	Дата в будущем, отрицательное значение, неизвестный `scope`, пустой или слишком длинный `data`