技能结果上传接口

• 请求消息

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

  POST {sendUrl}

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

  • 请求消息头

    技能以json形式返回推理结果，因此消息头Content-Type类型为“application/json”，参数说明如表5所示。

    表5 请求消息头参数说明

    名称	描述	是否必选	示例
    Content-Type	消息体的类型（格式）	是	application/json。

  • 公共消息体

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

    表6 公共消息体参数说明

    名称	类型	说明
    msg_type	String	技能类型，为face_detection_result。
    cam_name	String	摄像头名称。
    skill_id	String	技能ID。

  • 技能消息体

    人脸检测的json消息体如表7所示：

    表7 技能消息体参数说明

    名称	类型	说明
    face_id	String	人脸图UUID。
    track_id	Uint64	人脸的跟踪标记，相同的track_id表示同一个人脸。
    ori_img_id	String	人脸背景原始图UUID。
    time	Uint64	图片解码时间的时间戳，单位为秒。
    bbox	Object	人脸图在背景图中的位置信息。位置信息参数请参见表8。
    clarity	Float	人脸清晰度，范围[0,1]。
    face_image	String	人脸图BASE64编码结果。
    ori_image	String	原始图BASE64编码结果，如果配置不发送原始图，则无该字段。

    表8 bbox位置信息参数说明

    字段	类型	说明
    x	Int	人脸图左上角顶点x坐标值。
    y	Int	人脸图左上角顶点y坐标值。
    h	Int	人脸图高。
    w	Int	人脸图宽。

    人脸检测的json消息体示例如下：

    {   "msg_type": "face_detection_result",  "cam_name": "store001_pos2",  "skill_id": "f5c526eb6c51440c8a0ee5e3cc65f23c",  "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",  "track_id": 1,  "ori_img_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",  "time": 1527603463,  "bbox ": {             "x": 32,             "y": 379,             "w": 49,             "h": 65             },   "clarity": 0.55,   "face_image": "4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE...",   "ori_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

  • 响应消息体（可选）

    响应消息体通常以结构化格式（如json或xml）返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。