提取主动安全附件
POST /alm/att/upload
本接口用于请求服务启动提取终端主动安全报警附件任务。当服务的自动启动提取终端主动安全报警附件功能选项关闭时,可通过本接口实现由调用者自主触发提取任务。
- 任务启动后,如果终端在线,服务会向终端下发上传指令,终端上传完附件文件后,任务结束。随后调用者可再调用
GET /alm/att
接口查询附件状态及取得下载地址。如果终端不在线,或上传过程中由于终端网络异常导致上传中断,服务将在终端上线后,或恢复后,指引终端再次上传附件,直到报警的所有附件全部上传完成,或任务重试次数达到限定次数时中止。 - 任务因达到重试次数中止后,调用者可调用本接口再次启动新任务。
调用时应注意:
- 应该仅对有附件的报警(报警编码中的附件数大于0)启动提取任务
- 注意区分报警的开始和结束,应仅对报警开始事件启动提取任务
请求
POST https://n11.gratour.info:7011/v1/alm/att/upload
Content-Type: application/json
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA
{
"simNo": "13320200521",
"almNo": "30303030303030303030383838383030303031390000000000000000000021110817475025050000",
"almTyp": "6512",
"almLvl": 1
}
请求实体属性
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
simNo | string | Y | 终端识别号 |
almNo | string | Y | 终端ADAS报警编号的HEX编码 |
almTyp | string | Y | 终端ADAS报警类型编码,用于服务记录相关文件信息,参见:ADAS报警类型编码 |
almLvl | int | 报警级别,无报警级别时,不出现本属性 |
应答
{
"errCode": 0,
"message": "OK."
}
应答实体属性
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
errCode | int | Y | 错误码 |
message | string | Y | 错误信息 |