Этот запрос используется на виджетах на мобильных устройствах, чтобы по списку id можно было получить их объекты.
Если пришлют id, которого нет у пользователя, то ошибки не будет, он будет исключен из ответа.
GET/api/v1/cameras/showsHeaders |
Authorization | Bearer token |
Accept | application/json |
X-Client | ios-cctv|android-cctv|thick-legal|web |
X-UUID | unique device id |
Body |
idsrequired | array | Массив id камер, максимум можно прислать 25 штук |
Response |
|
200 | Возвращает камеры на i странице пагинации |
JSON
[
{
"id": 894,
"group_id": 190,
"status": "inactive",
"type": "media_server_v2",
"start_at": "",
"created_at": "2022-04-05 12:34:38",
"billing_id": null,
"pretty_name": "Камера 1",
"pretty_text": "Камеры,
"short_address": "Камеры,
"full_address": "Камеры,
"lat": null,
"lng": null,
"azimuth": null,
"streams": [
{
"id": 923,
"type": "high",
"camera_id": 894,
"is_preview_from_server": true,
"is_archive_from_server": null,
"status": "inactive",
"has_sound": false,
"width": null,
"height": null
}
],
"services": {
"ptz": false,
"motion_detect": true
},
"has_sound": false,
"archive_ranges": [],
"is_archive_recording": true,
"is_bridge": false,
"is_favorite": true,
"user_status": "active",
"name": "Камера 1"
}
]
|
|
401 | Токен авторизации не передан или не валидный, см. Получение токена |
|
422 | Возвращает JSON объект с ошибкой, см. Валидация |
JSON
{
"message": "Тут не будет информативного сообщения",
"errors": {
"any_key": [
"Тут будет описана причина ошибки"
]
}
}
|
Пример |
JSON
curl -k --location --request GET 'https://vms.local/api/v1/cameras/shows?ids=array' \
--header 'Authorization:Bearer token' \
--header 'Accept:application/json' \
--header 'X-Client:ios-cctv|android-cctv|thick-legal|web' \
--header 'X-UUID:unique device id'
|
