云存储模块

普通锁云存

获取云存列表

1. 请求链接: /lockCloudStorage/list

2. 请求方式: POST

3. 参数说明:

名称	类型	是否必需	示例	描述
lockId	int	Y	500	锁ID

4. 返回参数及示例:

参数	类型	描述
date	String	日期
recordList	Array	记录列表
recordId	Int	记录ID
operateDate	Long	操作时间
imagesUrl	String	图片URL
videoUrl	String	视频URL

[
  {
    "date": "2024-03-12",
    "recordList": [
      {
        "recordId": 42542,
        "operateDate": 1710208636599,
        "imagesUrl": "http://pre.oss-lock.star-lock.cn/starchart/T9A_d7d74b2f66b8-1710208617/964f08ca-1ff3-41f5-ad28-d15fdaf47508.jpg",
        "videoUrl": "http://pre.oss-lock.star-lock.cn/starchart/T9A_d7d74b2f66b8-1710208617/9097e148-e9f2-478d-bcf0-b99fd4e910a5.mp4"
      }
    ]
  },
  {
    "date": "2024-03-11",
    "recordList": [
      {
        "recordId": 42543,
        "operateDate": 1710208636599,
        "imagesUrl": "http://pre.oss-lock.star-lock.cn/starchart/T9A_d7d74b2f66b8-1710208617/964f08ca-1ff3-41f5-ad28-d15fdaf47508.jpg",
        "videoUrl": "http://pre.oss-lock.star-lock.cn/starchart/T9A_d7d74b2f66b8-1710208617/9097e148-e9f2-478d-bcf0-b99fd4e910a5.mp4"
      }
    ]
  }
]

删除云存数据

1. 请求链接: /lockCloudStorage/delete

2. 请求方式: POST

3. 参数说明:

名称	类型	是否必需	示例	描述
recordIds	array	Y	[42543]	云存数据ID

4. 返回参数及示例:

参数	类型	描述
errorCode	Int	错误码
description	String	描述
errorMsg	String	错误信息
data	Object	返回数据

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": null
}

腾讯锁云存

获取云存储服务信息

1. 请求链接: /api/v1/starlock/passthrough

2. 请求方式: POST

3. 参数说明:

名称	类型	是否必需	示例	描述
request_method	string	Y	POST	请求方法 GET/POST
request_uri	string	Y	/api/v1/cloudStorage/getStorageServiceInfo	请求星云地址
post_args	object	Y	-	请求参数
lockId	int	Y	205	锁ID

4. 返回参数及示例:

参数	类型	描述
lockId	int	锁ID
status	int	状态 0:未开通 1:已开通 2:已过期
validityPeriodStart	string	有效期开始时间
validityPeriodEnd	string	有效期结束时间
rollingStorageDays	int	滚动存储天数
remainingDays	int	剩余天数

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": {
    "lockId": 205,
    "status": 0,
    "validityPeriodStart": "",
    "validityPeriodEnd": "",
    "rollingStorageDays": 0,
    "remainingDays": 0
  }
}

获取云存储事件记录列表

1. 请求链接: /api/v1/starlock/passthrough

2. 请求方式: POST

3. 参数说明:

名称	类型	是否必需	示例	描述
request_method	string	Y	POST	请求方法 GET/POST
request_uri	string	Y	/api/v1/cloudStorage/getStorageEventList	请求星云地址
post_args	object	Y	-	请求参数
lockId	int	Y	205	锁ID
pageNo	int	N	1	页码
pageSize	int	N	10	每页条数

4. 返回参数及示例:

参数	类型	描述
pageNo	int	页码
pageSize	int	每页条数
total	int	总数
list	Array	事件列表
event_id	string	事件ID
device_id	int	设备ID
event_type	int	事件类型
event_type_name	string	事件类型名称
event_time	int	事件时间
preview_image	string	预览图片
video	string	视频URL
text	string	文本描述
video_expire_at	int	视频过期时间
payload	string	负载数据

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": {
    "pageNo": 1,
    "pageSize": 10,
    "total": 1,
    "list": [
      {
        "event_id": "tIkDSKXA",
        "device_id": 3237237942,
        "event_type": 7,
        "event_type_name": "徘徊告警",
        "event_time": 1748404291,
        "preview_image": "https://example.com/preview.jpg",
        "video": "https://example.com/video.mp4",
        "text": "检测到运动",
        "video_expire_at": 1748663491,
        "payload": "{\"key\":\"value\"}"
      }
    ]
  }
}

事件类型说明: 以apiserver文档为准，APP显示event_type_name和text即可

删除事件

1. 请求链接: /api/v1/starlock/passthrough

2. 请求方式: POST

3. 参数说明:

名称	类型	是否必需	示例	描述
request_method	string	Y	POST	请求方法 GET/POST
request_uri	string	Y	/api/v1/cloudStorage/delStorageEvent	请求星云地址
post_args	object	Y	-	请求参数
eventId	string	Y	tIkDSKXA	事件ID

4. 返回参数及示例:

参数	类型	描述
errcode	int	错误码
errmsg	string	错误信息
description	string	描述

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": {
    "errcode": 0,
    "errmsg": "none error message",
    "description": "表示成功或是。"
  }
}

清空事件

1. 请求链接: /api/v1/starlock/passthrough

2. 请求方式: POST

3. 参数说明:

名称	类型	是否必需	示例	描述
request_method	string	Y	POST	请求方法 GET/POST
request_uri	string	Y	/api/v1/cloudStorage/clearStorageEvent	请求星云地址
post_args	object	Y	-	请求参数
lockId	int	Y	205	锁ID

4. 返回参数及示例:

参数	类型	描述
errcode	int	错误码
errmsg	string	错误信息
description	string	描述

{
  "errorCode": 0,
  "description": "success",
  "errorMsg": "success",
  "data": {
    "errcode": 0,
    "errmsg": "none error message",
    "description": "表示成功或是。"
  }
}