17. 批量同步白名单

描述：

下发URL文件地址，批量同步白名单，设备无该名单会新增，有该名单会覆盖。

注意：
1、文件格式需使用.txt文本格式，
2、文件需要是utf-8编码，否则存在中文会乱码
3、文件内容须符合规定的json格式，一行一个json

请求说明：

协议 方法 PATH
HTTPS POST /openApi/camera/urlSyncWhites

Body参数：

参数 类型 必填 说明
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：cameraUrlSyncWhites
data String 是 白名单文件地址
- url String 是 白名单文件地址，格式参考上方注意事项

返回参数：

参数 类型 必填 说明
code int 是 响应状态码
msg String 是 响应消息
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：cameraUrlSyncWhites
data String 是 空字符串，固定值：””

文件参数：

参数名 必选 类型 说明
plate 是 String 车牌号码，例：粤A5687E
startTime 是 String 开启时间，例：2025-12-22 00:00:00
endTime 是 String 截止时间，例：2025-12-23 00:00:00
enable 是 int 白名单是否启用，0：禁用，1：启用
isBlack 是 int 是否是黑名单，0：否，1：是
color 否 int 车身颜色，0：未知，1：白，2：灰（银），3：黄，4：粉，5：红，6：绿，7：蓝，8：棕，9：黑
plateType 否 int 车牌类型，0：未知，1：蓝牌，2：黑牌，3：单排黄牌，4：双排黄牌，5：警车车牌，6：武警车牌，7：个性化车牌，8：单排军车牌，9：双排军车牌，10：使馆车牌，11：香港进出中国大陆车牌，12：农用车牌，13：教练车牌，14：澳门进出中国大陆车牌，15：双层武警车牌，16：武警总队车牌，17：双层武警总队车牌，18：民航车牌，19：新能源车牌，20：应急车牌，21：双层应急车牌
remark 否 String 备注

文件格式：

{"plate": "粤A45RWS","startTime": "2026-01-12 12:00:11","endTime": "2026-01-12 15:00:12","enable": 1,"isBlack": 0,"color": null,"plateType": null,"remark": ""}
{"plate": "粤B99TS1","startTime": "2026-08-12 12:00:11","endTime": "2026-09-12 15:00:12","enable": 1,"isBlack": 0,"color": null,"plateType": null,"remark": ""}

请求示例：

{
    "appId": "ym3b7f242fc0814489",
    "expires": "1739583239",
    "sign": "36f392b389e945b5c7ca8baa36fae53b",
    "deviceNo": "123456789-987654321",
    "cmd": "cameraUrlSyncWhites",
    "data": "{\"url\":\"https://file.ymlot.cn/mercloud/productimg/kunshan.txt\"}"}

返回示例：

{
    "code": 0,
    "msg": "操作成功",
    "appId": "ymc03e8b5544714290",
    "expires": "1767858071",
    "sign": "1d8b5f21e27a73e1e19b1487045e64ab",
    "deviceNo": "123456789-987654321",
    "cmd": "cameraUrlSyncWhites",
    "data": ""
}
作者：吴勇  创建时间：2026-08-31 09:21
最后编辑：yrh  更新时间：2026-09-18 15:10