Skip to content

Импорт камер по API

Импорт камер выполняется через POST запрос на URL http(s)://URL_ВАШЕГО_ВОТЧЕРА/vsaas/api/v2/cameras/import

Импорт через команду в консоли:

curl http://127.0.0.1:80/vsaas/api/v2/cameras/import \
--data-binary @mydata.csv -H 'Content-type:text/csv' -H 'x-vsaas-api-key: <your api key>'

Пример файла mydata.csv:

stream_url,substream_url,thumbnails,onvif_url,onvif_profile,ptz,dvr_depth,dvr_path,enabled,access,title
rtsp://127.0.0.1:554,,,http://127.0.0.1:8899,000,0,3,storage,1,private,office_cam1
rtsp://127.0.0.2:554,,,http://127.0.0.2:8899,000,0,3,storage,1,private,office_cam2

Ответ:


{
    "created": 2,
    "updated": 0,
    "deleted": 0,
    "errors": {}
}

Пример одной строкой:

echo -e "stream_url,substream_url,thumbnails,onvif_url,onvif_profile,ptz,dvr_depth,dvr_path,enabled,access,title\nrtsp://127.0.0.1:554,,,http://127.0.0.1:8899,000,0,3,storage,1,private,office_cam1\nrtsp://127.0.0.2:554,,,http://127.0.0.2:8899,000,0,3,storage,1,private,office_cam2" | curl http://127.0.0.1:80/vsaas/api/v2/cameras/import --data-binary @-  -H 'Content-type:text/csv' -H 'x-vsaas-api-key: 3a7d9386-6c3a-440d-a75d-e6b3fdc3368e'

Ответ:

{
  "zu": 0, 
  "cameras": [
    {"name": "office_cam2-689f1b1548", "created": true}, 
    {"name": "office_cam1-c0ce3faa10", "created": true}
  ], 
  "users": [], 
  "success": true, 
  "zc": 2
}

Надо передать CSV или список JSON-объектов со следующими полями:

  • title: название камеры.
  • name: название потока. По умолчанию — title плюс случайный суффикс.
  • static: 1 — постоянно работающий поток (static), 0 — поток по запросу (ondemand).
  • stream_url: RTSP URL основного потока.
  • substream_url: RTSP URL вторичного видеопотока (для мультибитрейта). По умолчанию нет.
  • thumbnails (строка): URL снепшотов с камеры. Отправив 0 вместо URL вы можете сбросить адрес thumbnails. Если вы не знаете URL снепшотов с камеры, передайте в строке значение 1 и их включит Watcher (в данном варианте будет 10% увеличение нагрузки на сервер, рекомендуем использовать URL, для общения с камерой напрямую).
  • onvif_url: URL по которому камера будет отвечать по onvif протоколу. По умолчанию нет.
  • onvif_profile: ONFIV profile
  • ptz: (0 или 1) — вкл/выкл PTZ (если камера поддерживает)
  • access: тип доступа к камере: (private/public/authorized) — видимость камеры, публичная она будет (для всех абонентов) или приватная (только для owner'а камеры). По умолчанию — private.
  • owner: (логин привязанного абонента / владельца камеры)
  • enabled: (0 или 1) — вкл/выкл камеры.
  • dvr_path: путь для сохранения архива. По умолчанию — архива нет.
  • dvr_depth: (целое число в днях) — количество дней записи архива для камеры. 0 — отключает архив.
  • coordinates: координаты.
  • postal_address: адрес.
  • comment: комментарий.
  • agent_model (строка): модель камеры.
  • agent_serial (строка): серийный номер камеры.
  • agent_id (строка): уникальный номер агента на камере.
  • agent_key (строка): специальное поле, используемое для авторизации камеры в Flussonic Watcher.
  • agent_pin (строка): специальное поле, используемое для авторизации камеры в Flussonic Watcher.