根据过滤条件查询图片-图像搜索(Image Search)-阿里云帮助中心

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	SearchImageByFilter	系统规定参数。取值：SearchImageByFilter。
InstanceName	String	是	demoinstance1	图搜实例名称。最多支持20个字符。如果已经购买图搜实例可登录图像搜索管控台查看。如果没有购买图搜实例可参考开通服务和创建实例。说明这里的实例名称并非实例ID，使用时请区分。
Num	Integer	否	10	返回结果的数目。取值范围：1~100。默认值为10。
Start	Integer	否	0	返回结果的起始位置。取值范围：0~499。默认值为0。
Filter	String	是	int_attr=1000 AND str_attr="value1"	过滤条件。int_attr支持的操作符有in、not in、大于号(>)、大于等于号(>=)、小于号(<)、小于等于号(<=)、等于号(=)。str_attr支持的操作符有in、not in、等于号(=)和不等号(!=)，多个条件之间支持AND和OR进行连接。例如： int_attr >= 100。 str_attr != "value1"。 int_attr = 1000 AND str_attr = "value1"。说明最多支持4096个字符。

返回数据

名称	类型	示例值	描述
Msg	String	success	错误信息。
RequestId	String	B3137727-7D6E-488C-BA21-0E034C38A879	请求ID。
Auctions	Array of Auction		所有返回的商品描述信息。
ProductId	String	2092061_1	商品ID。
PicName	String	2092061_1.jpg	图片名称。
CategoryId	Integer	8888888	图片类目。
CustomContent	String	zidingyi	用户自定义的内容。
IntAttr	Integer	2	整数类型属性。
IntAttr2	Integer	2	整数类型属性。
StrAttr2	String	test	字符串类型属性。
StrAttr	String	test	字符串类型属性。
StrAttr3	String	test	字符串类型属性。
StrAttr4	String	test	字符串类型属性。
IntAttr3	Integer	2	整数类型属性。
IntAttr4	Integer	2	整数类型属性。
Code	Integer	0	错误码。 0：成功。非0：失败。
Success	Boolean	true	请求是否成功。

示例

请求示例

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SearchImageByFilterResponse>
    <Msg>success</Msg>
    <RequestId>B3137727-7D6E-488C-BA21-0E034C38A879</RequestId>
    <Auctions>
        <ProductId>2092061_1</ProductId>
        <PicName>2092061_1.jpg</PicName>
        <CategoryId>8888888</CategoryId>
        <CustomContent>zidingyi</CustomContent>
        <IntAttr>2</IntAttr>
        <IntAttr2>2</IntAttr2>
        <StrAttr2>test</StrAttr2>
        <StrAttr>test</StrAttr>
        <StrAttr3>test</StrAttr3>
        <StrAttr4>test</StrAttr4>
        <IntAttr3>2</IntAttr3>
        <IntAttr4>2</IntAttr4>
    </Auctions>
    <Code>0</Code>
    <Success>true</Success>
</SearchImageByFilterResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Msg" : "success",
  "RequestId" : "B3137727-7D6E-488C-BA21-0E034C38A879",
  "Auctions" : [ {
    "ProductId" : "2092061_1",
    "PicName" : "2092061_1.jpg",
    "CategoryId" : 8888888,
    "CustomContent" : "zidingyi",
    "IntAttr" : 2,
    "IntAttr2" : 2,
    "StrAttr2" : "test",
    "StrAttr" : "test",
    "StrAttr3" : "test",
    "StrAttr4" : "test",
    "IntAttr3" : 2,
    "IntAttr4" : 2
  } ],
  "Code" : 0,
  "Success" : true
}