提交图片异步检测人脸1:1比对任务后,调用本接口查询检测结果。

描述

业务接口/green/image/results

客户端定时轮询查询异步检测结果。建议您将查询间隔设置为30秒,最长不能超出1个小时,否则结果将会丢失。

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON数组,字段说明如下:
名称 类型 是否必需 描述
body JSON数组 要查询的taskId列表。最大长度不超过1,000。

返回参数

返回结果说明,参见返回结果

返回body中的Data字段是JSON数组,每一个元素包含如下字段:
名称 类型 是否必需 描述
code 整型 错误码,和HTTP的status code一致。
msg 字符串 错误描述信息。
dataId 字符串 对应的请求中的dataId
taskId 字符串 该检测任务的ID。
url 字符串 对应的请求中的URL。
results 数组 返回结果。调用成功时(code=200),返回结果中包含一个或多个元素。每个元素是个结构体,具体结构描述见result
extras JSON对象 附加信息。该值可能会调整,建议您不要在业务上进行依赖。
表 1. result
名称 类型 是否必需 描述
scene 字符串 风险场景,取值:sface-1
label 字符串 检测结果的分类,取值:
  • normal:第二张图片和第一张图片的相似度低
  • sface-1:第二张图片和第一张图片的相似度高
suggestion 字符串 建议用户执行的操作,取值范围:
  • pass:图片相似度低,无需进行其余操作
  • review:图片相似度高,建议执行进一步操作
rate 浮点数 结果为该分类的概率,取值范围为[0.00-100.00]。值越高,表示越有可能属于该分类。

示例

请求示例
["fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695"]
返回示例
{
  "code":200,
  "msg":"OK",
  "requestId":"9EEF894F-A933-4830-97B1-EC1A9630A9D6"
  "data":[
	{
	  "code":200,
	  "dataId":"e6b080a8-a91a-11e8-bac4-6c96cfde2af9",
	  "taskId":"img2hsbmQeA4CU7l78$s8q5mW-1pnn7Z",
	  "url":"http://v2img.ifensi.com/2015/0826/2015082612403321.jpg"
	  "extras":{}
	  "msg":"OK",
	  "results"
	    {
		  "label"sface-1",
		  "rate":97.0,
		  "scene:"sface-1",
		  "suggestion":"review"
		}
	  ]
	}
  ]
}