调用该接口,查询一体化以图搜图任务的图片检索结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | QueryPictureSearchJobResult | 系统规定参数。取值:QueryPictureSearchJobResult。 |
AppInstanceId | String | 是 | fdc576d03c094faea9fa10fbf48c**** | 以图搜图应用实例ID。可调用QueryPictureSearchApps查询。 |
CurrentPage | Integer | 是 | 1 | 指定从返回结果中的第几页开始显示。页数从1开始排序。 |
JobId | String | 是 | b7e501d0d2524a4caeb50df3282a**** | 一体化以图搜图任务ID。可调用QueryPictureSearchJob查询。 |
PageSize | Integer | 是 | 10 | 每页显示的条数。最小值为1,最大值为50,默认值为10。 |
调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档。
返回数据
名称 | 类型 | 示例值 | 描述 |
Code | String | 200 | 调用失败时,返回的错误码。更多信息,请参见错误码。 |
Data | Struct | 响应结果。 |
|
CurrentPage | Integer | 1 | 当前页面号。 |
PageCount | Integer | 1 | 总页数。 |
PageData | Array of searchData | 查询结果。 |
|
DeviceNickName | String | camera1 | 设备别名。 说明 若设备未设置设备别名,则不返回此参数。 |
EventTime | Long | 1614333155075 | 创建事件的时间,格式为毫秒级的13位时间戳,单位为毫秒。 |
GatewayIotId | String | pZJUqijOyfpFOOGNPF7S00**** | V系列边缘一体机的IotId。 |
IotId | String | 5RUngwC1RknD4lPiHgH300**** | 查询的设备的IotId。 |
PicUrl | String | https://xxx.xxx.xxx.com/xxx | 待检索图片的地址。 |
Threshold | Float | 0.5 | 人脸相似度。 |
VectorId | String | vectorId86d9a5c32b9947278e526c2eef8a**** | 图片特征ID。 |
PageSize | Integer | 10 | 每页显示的条数。 |
Total | Integer | 1 | 总条数。 |
ErrorMessage | String | AppInstanceId is mandatory for this action. | 调用失败时,返回的出错信息。 |
RequestId | String | a06c4750-7cce-11eb-8010-557d50136505 | 阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true | 是否调用成功:
|
示例
请求示例
http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryPictureSearchJobResult
&AppInstanceId=fdc576d03c094faea9fa10fbf48c****
&CurrentPage=1
&JobId=b7e501d0d2524a4caeb50df3282a****
&PageSize=10
&<公共请求参数>
正常返回示例
XML
格式
<QueryPictureSearchJobResultResponse>
<RequestId>a06c4750-7cce-11eb-8010-557d50136505</RequestId>
<Data>
<PageSize>10</PageSize>
<PageCount>1</PageCount>
<CurrentPage>1</CurrentPage>
<Total>1</Total>
<PageData>
<IotId>5RUngwC1RknD4lPiHgH300****</IotId>
<EventTime>1614333155075</EventTime>
<DeviceNickName>camera1</DeviceNickName>
<GatewayIotId>pZJUqijOyfpFOOGNPF7S00****</GatewayIotId>
<PicUrl>https://xxx.xxx.xxx.com/xxx</PicUrl>
<Threshold>0.5</Threshold>
<VectorId>vectorId86d9a5c32b9947278e526c2eef8a****</VectorId>
</PageData>
</Data>
<Code>200</Code>
<Success>true</Success>
</QueryPictureSearchJobResultResponse>
JSON
格式
{
"RequestId": "a06c4750-7cce-11eb-8010-557d50136505",
"Data": {
"PageSize": "10",
"PageCount": "1",
"CurrentPage": "1",
"Total": "1",
"PageData": [
{
"IotId": "5RUngwC1RknD4lPiHgH300****",
"EventTime": "1614333155075",
"DeviceNickName": "camera1",
"GatewayIotId": "pZJUqijOyfpFOOGNPF7S00****",
"PicUrl": "https://xxx.xxx.xxx.com/xxx",
"Threshold": "0.5",
"VectorId": "vectorId86d9a5c32b9947278e526c2eef8a****"
}
]
},
"Code": "200",
"Success": "true"
}
文档内容是否对您有帮助?