跳到主要内容
版本：4.0

提取主动安全附件

POST /alm/att/upload

本接口用于请求服务启动提取终端主动安全报警附件任务。当服务的自动启动提取终端主动安全报警附件功能选项关闭时，可通过本接口实现由调用者自主触发提取任务。

WebSocket 对等：almAtt/upload（StrmWsApi.reqAlmAttUpload）；内存队列见 almAtt/queue（WS 文档）。

  • 任务启动后，如果终端在线，服务会向终端下发上传指令，终端上传完附件文件后，任务结束。随后调用者可再调用GET /alm/att 接口查询附件状态及取得下载地址。如果终端不在线，或上传过程中由于终端网络异常导致上传中断，服务将在终端上线后，或恢复后，指引终端再次上传附件，直到报警的所有附件全部上传完成，或任务重试次数达到限定次数时中止。
  • 任务因达到重试次数中止后，调用者可调用本接口再次启动新任务。
  • 调度按 (priority DESC, reqTm ASC) 排队；不抢占已在执行中的任务。同 almNo 重复请求：若已在执行则不打断；若仍在排队则 priority 取两者较大值，guid/ai 取最新请求。
  • 任务成功结束后，除向 fetch-alm-att-completed 推送通知外，还可选向 Kafka topic eeye-stm-evidence 双发（见 伊爱主动安全证据完成事件）。

调用时应注意：

  1. 应该仅对有附件的报警（报警编码中的附件数大于0）启动提取任务
  2. 注意区分报警的开始和结束，应仅对报警开始事件启动提取任务

请求​

POST https://wx.gratour.info:7200/v1/alm/att/upload
Content-Type: application/json
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA

{
  "simNo": "13320200521",
  "almNo": "30303030303030303030383838383030303031390000000000000000000021110817475025050000",
  "almTyp": "0214",
  "almLvl": 1,
  "priority": 3,
  "guid": 961916803414524930,
  "ai": true
}

请求实体属性​

属性数据类型必要说明
simNostringY终端识别号
almNostringY终端ADAS报警编号的HEX编码
almTypstringY终端ADAS报警类型编码，用于服务记录相关文件信息，参见：ADAS报警类型编码。此信息将被媒体服务记录到附件信息中，并在查询中返回。但媒体服务不对此数据做其他业务逻辑。
almLvlint报警级别，无报警级别时，不出现本属性。此信息将被媒体服务记录到附件信息中，并在查询中返回。但媒体服务不对此数据做其他业务逻辑。
priorityint下载优先级，取值 0–5。不提供时服务端默认 3。越界返回参数错误。
guidlong平台唯一 ID，用于结果匹配；可选。落库并在完成通知 / eeye-stm-evidence 原值回传。
aiboolean是否需要 AI 分析（带外字段）；可选。落库并在完成通知 / eeye-stm-evidence 原值回传。

应答​

{
  "errCode": 0,
  "message": "OK."
}

应答实体属性​

属性数据类型必要说明
errCodeintY错误码
messagestringY错误信息