調用該接口,查詢一體化以圖搜圖任務的圖片檢索結果。
調試
您可以在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"
}
文檔內容是否對您有幫助?