QueryPictureSearchJob-阿里云帮助中心

一体化以图搜图，表示搜图时，同时检索人脸和人体。

说明该功能需要在V系列边缘一体机上部署人脸和人体检测算法。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	QueryPictureSearchJob	系统规定参数。取值：QueryPictureSearchJob。
AppInstanceId	String	是	fdc576d03c094faea9fa10fbf48c****	以图搜图应用实例ID。可调用QueryPictureSearchApps查询。
CurrentPage	Integer	是	1	指定从返回结果中的第几页开始显示。页数从1开始排序。
PageSize	Integer	是	10	每页显示的条数。最小值为1，最大值为50，默认值为10。
JobStatus	Integer	否	3	任务状态： 0：初始化 1：无数据 2：运行中 3：运行成功 4：运行失败若不设置此参数，表示选择所有状态。

调用API时，除了本文介绍的该API的特有请求参数，还需传入公共请求参数。公共请求参数说明，请参见公共参数文档。

返回数据


名称	类型	示例值	描述
Code	String	200	调用失败时，返回的错误码。更多信息，请参见错误码。
Data	Struct		响应结果。
CurrentPage	Integer	1	当前页面号。
PageCount	Integer	1	总页数。
PageData	Array of pageData		应用列表。
CreateTime	Long	1614850763000	创建以图搜图任务的时间，格式为13位时间戳，单位为毫秒。
EndTime	Long	1614850763692	检索范围结束时间，格式为13位时间戳，单位为毫秒。
JobId	String	b3786935a71442efae014c7b2212****	以图搜图任务ID。
JobStatus	Integer	3	任务状态： 0：初始化 1：无数据 2：运行中 3：运行成功 4：运行失败
SearchPicUrl	String	http://xxx.xxx.com/1.jpg	检索的图片地址。
StartTime	Long	1614814763692	检索范围起始时间，格式为13位时间戳，单位为毫秒。
Threshold	Float	0.5	检索相似度。
PageSize	Integer	10	每页显示的条数。
Total	Integer	2	总条数。
ErrorMessage	String	Specified access key is not found.	调用失败时，返回的出错信息。
RequestId	String	8FAF4001-2A53-46DF-B83E-306B8070E131	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功： true：调用成功。 false：调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryPictureSearchJob
&AppInstanceId=fdc576d03c094faea9fa10fbf48c****
&CurrentPage=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML格式

<QueryPictureSearchJobResponse>
  <RequestId>8FAF4001-2A53-46DF-B83E-306B8070E131</RequestId>
  <Data>
        <PageSize>10</PageSize>
        <PageCount>1</PageCount>
        <CurrentPage>1</CurrentPage>
        <Total>1</Total>
        <PageData>
              <JobStatus>3</JobStatus>
              <EndTime>1614850763692</EndTime>
              <CreateTime>1614850763000</CreateTime>
              <StartTime>1614814763692</StartTime>
              <SearchPicUrl>http://xxx.xxx.com/1.jpg</SearchPicUrl>
              <JobId>b3786935a71442efae014c7b2212****</JobId>
              <Threshold>0.5</Threshold>
        </PageData>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</QueryPictureSearchJobResponse>

JSON格式

{
    "RequestId": "8FAF4001-2A53-46DF-B83E-306B8070E131",
    "Data": {
        "PageSize": "10",
        "PageCount": "1",
        "CurrentPage": "1",
        "Total": "1",
        "PageData": [
            {
                "JobStatus": "3",
                "EndTime": "1614850763692",
                "CreateTime": "1614850763000",
                "StartTime": "1614814763692",
                "SearchPicUrl": "http://xxx.xxx.com/1.jpg",
                "JobId": "b3786935a71442efae014c7b2212****",
                "Threshold": "0.5"
            }
        ]
    },
    "Code": "200",
    "Success": "true"
}

错误码


HttpCode	错误码	错误信息	描述
400	Forbidden.RiskControl	Your account is at risk. Contact customer support for more details.	无权限

访问错误中心查看更多错误码。