视频服务

获取设备视频地址

接口描述: 指定设备的SN号和通道号获取设备的视频播放地址。

接口地址: https://yd.yunding360.com/openapi/videos/{sn}/{channelNo}

请求方式: GET

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
sn	设备SN号	path	true	string
channelNo	设备通道号，IPC设备传入0	path	true	integer

响应示例

{
  "channelNo": 0,
  "deviceSn": "",
  "playUrls": [],
  "playbackUrl": "",
  "recordListUrl": "",
  "status": true
}

响应参数

参数名称	参数说明	类型	schema
channelNo	通道号	integer
deviceSn	设备sn号	string
playUrls	实时视频的播放地址，RTMP格式	array
playbackUrl	录像的回放地址，通过该地址可回放设备录像（如果传入查询IPC设备，需保证同一门店中存在录像设备）。在播放时，先将该地址中的{playback_ts}（包括大括号）替换为需回放录像的时间点的时间戳timestamp（从1970-01-01起的毫秒数）、{current_ts}（包括大括号）替换为当前时刻的时间戳timestamp后，传递给播放器进行播放。	string
recordListUrl	录像查询列表，通过该地址可查询设备的录像列表。在查询录像时，先将该地址中的{start_time}（包括大括号）替换为录像查询的起始时刻的时间（格式为“yyyy-MM-ddTHH:mm:ss”，例如：2020-06-16T09:50:11）、{end_time}（包括大括号）替换为录像查询的截至时刻的时间后，再通过HTTP请求该地址，可得到查询时间范围内该设备的录像列表。录像列表中标明了存在录像的时间段，可以用于生成录像时间轴。请避免一次查询长时间范围内的录像，建议起、止时间不超过1天。	string
status	状态	boolean

获取视频操作记录

接口描述: 分页查询视频操作记录。

接口地址: https://yd.yunding360.com/openapi/videos/video_operation_history

请求方式: POST

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
page	页数(从0开始计数,默认为0)	query	true	integer
size	每页数量(默认20)	query	true	integer
account	用户账号(模糊搜索)	body	false	string
storeName	门店名称(模糊搜索)	body	false	string
sn	设备SN(模糊搜索)	path	false	string
deviceName	设备名称(模糊搜索)	path	false	string
operationType	操作类型,可选值: VIDEO_PLAY（视频播放）, VIDEO_PLAYBACK（录像回放）, VIDEO_DOWNLOAD（录像下载）	path	false	string
platformType	平台类型,可选值: WEB（web端）, IOS（IOS端）, ANDROID（Android端）	path	false	string
videoStartTime	视频开始时间，时间戳（毫秒）	body	false	Long
videoEndTime	视频结束时间，时间戳（毫秒）	body	false	Long
operationStartTime	操作开始时间，时间戳（毫秒）	body	false	Long
operationEndTime	操作结束时间，时间戳（毫秒）	body	false	Long

响应示例

{
  "content": [
    {
      "id": "5d3c291a-16a3-11f1-b7d1-93b4cdfb9f2e",
      "enterpriseCode": null,
      "storeId": "83a0ea02-ef01-11ed-bb2f-87e58e17eab7",
      "storeName": "XX门店",
      "userId": "eaaeddde-c790-11ed-a2e3-57bf659bc0d2",
      "userName": "userName1",
      "account": "account1",
      "deviceId": "45fda716-db16-11f0-86c5-b1695df8832e",
      "sn": "sn1",
      "deviceName": "deviceName1",
      "operationType": "VIDEO_PLAY",
      "platformType": "ANDROID",
      "ip": "10.234.220.22",
      "region": "未知",
      "videoStartTime": 1772502632112,
      "videoEndTime": 1772502649979,
      "operationStartTime": 1772502632112,
      "operationEndTime": 1772502649979,
      "createTime": 1772502632492
    }
  ],
  "metadata": {
    "size": 20,
    "totalElements": 1,
    "totalPages": 1,
    "page": 0
  },
  "expandedInfo": null
}

响应参数

参数名称	参数说明	类型	schema
id	数据ID	uuid
enterpriseCode	企业Code	string
storeId	门店ID	uuid
storeName	门店名称	string
userId	用户ID	uuid
userName	用户名称	string
account	用户账号	string
deviceId	设备ID	uuid
sn	设备SN	string
deviceName	设备名称	string
operationType	操作类型	string
platformType	平台类型	string
ip	IP地址	string
region	地区	string
videoStartTime	视频开始时间	Long
videoEndTime	视频结束时间	Long
operationStartTime	操作开始时间	Long
operationEndTime	操作结束时间	Long