华为云首页用户手册

华为HILENS-安全帽检测技能:技能结果上传接口

时间：2024-04-03 16:00:19

华为HILENS

技能结果上传接口

请求消息

推理结果将以HTTPS POST请求方法推送到应用系统server的指定URL地址。

POST {sendUrl}

其中sendUrl在技能运行时配置中设置。

请求消息头

技能以json形式返回推理结果，因此消息头“Content-Type”类型为“application/json”。消息头其它部分，用户可根据自身的业务需求设定，如鉴权等。

表4 请求消息头参数说明
名称	描述	是否必选	示例
Content-Type	消息体的类型（格式）	是	application/json

公共消息体

HiLens公共消息体包含了技能的公共消息内容，如表5所示。

表5 公共消息体参数说明
名称	类型	说明
msg_type	Enum	消息类型，包括“no_helmet_alert”和“heatbeat”两种。
skill_id	String	技能ID。

技能心跳消息体

技能心跳的json消息体包含一个时间戳信息：

表6 技能心跳消息体参数说明
名称	类型	说明
time	Uint64	心跳时间戳。

公共消息体示例

{ 
  "msg_type": "heartbeat",
  "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c",
  "time": 1527603463
}

技能消息体

安全帽检测的json消息体如表7所示：

表7 技能消息体参数说明
名称	类型	说明
camera_name	String	摄像头名称。
image_id	String	摄像头原始图UUID。
time	Uint64	检测到未戴安全帽人头时的时间戳。
bounding_box	Array	未戴安全帽人头在背景图中的位置信息，其参数说明如表8所示。
image	String	原始图BASE64编码结果，如果配置不发送原始图，则为空字符串。

表8 “bounding_box”参数说明
字段	类型	说明
x	Int	人头图左上角顶点x坐标值。
y	Int	人头图左上角顶点y坐标值。
h	Int	人头图高。
w	Int	人头图宽。

安全帽检测的消息体示例：

{ 
  "msg_type": "no_helmet_alert",
  "camera_name": "constructsite01_pos02",
  "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c",
  "image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
  "time": 1527603463,
  "bounding_box ": [{
                         "x": 32,
                         "y": 379,
                         "w": 49,
                         "h": 65
                         },
                         {
                         "x": 54,
                         "y": 632,
                         "w": 36,
                         "h": 95
                         }
                      ],
  "image": "4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE...",
}

响应消息

响应消息头

响应消息头由服务器端(应用系统)收到请求消息后返回。

响应消息头可包含如下两部分。

一个HTTP状态代码，从2xx成功代码到4xx或5xx错误代码。或者可以返回服务定义的状态码。

附加响应头字段，如支持请求的响应所需，如Content-type响应消息头。

详细的公共响应消息头字段如表9所示。

表9 公共响应消息头参数说明
名称	描述	示例
Date	HTTP协议标准报头。表示消息发送的时间，时间的描述格式由rfc822定义。	Mon, 12 Nov 2007 15:55:01 GMT
Server	HTTP协议标准报头。包含了服务器用来处理请求的软件信息。	Apache
Content-Length	HTTP协议标准报头。用于指明实体正文的长度，以字节方式存储的十进制数字来表示。	xxx
Content-Type	HTTP协议标准报头。用于指明发送给接收者的实体正文的媒体类型。	application/json