图像搜索
接口路径
POST /api/search/image
请求方法
POST
频率限制
详见套餐说明
请求体
请求体为json对象
| 参数名 | 参数类型 | 备注 |
|---|---|---|
imageBase64 | String | 与imageUrl二选一,dataURI格式的图片base64编码,例如:data:image/jpeg;base64,xxxx |
imageUrl | String | 与imageBase64二选一,图片url |
region | String | 用户选择的当前切图返回的坐标,不能超过图片边界 |
请求体示例
{
"imageBase64": "data:image/jpeg;base64,xxxx",
"imageUrl": "https://www.test.com/test.png",
"region": "421,1678,538,2243"
}
响应体
| 字段名 | 字段类型 | 备注 |
|---|---|---|
code | Integer | 状态码,200 表示成功 |
msg | String | 返回消息,成功时为 null |
data | Array | 联想词列表,包含联想词和出现次数 |
data.multiRegion | Array | 图片识别出的多个区域坐标,格式为 x1,x2,y1,y2 字符串 |
data.currentRegion | String | 当前结构区域坐标,格式为 x1,x2,y1,y2 字符串 |
data.products | Array | 商品数组 |
data.products[].brand | string | 商品品牌 |
data.products[].productId | string | 商品聚合 ID |
data.products[].productName | string | 商品名称 |
data.products[].mainImage | string | 商品白底图 |
data.products[].imageUrls | array | 商品图片 URL 列表 |
data.products[].description | string | 商品描述 |
data.products[].gender | string | 商品适用性别 |
data.products[].series | string | 商品系列 |
data.products[].category | string | 商品分类 |
data.products[].style | string | 商品款式 |
data.products[].color | string | 商品颜色 |
data.products[].size | string | 商品尺寸 |
data.products[].material | string | 商品材质 |
data.products[].design | string | 商品设计 |
data.products[].price | number | 商品价格 |
data.products[].discountPrice | number | 商品折扣价 |
data.products[].status | integer | 商品状态 |
data.products[].isNew | string | 是否为新商品 |
data.products[].releaseDate | string | 商品发布日期 |
data.products[].attr1 | string | 自定义冗余字段 |
data.products[].attr2 | string | 自定义冗余字段 |
data.products[].attr3 | string | 自定义冗余字段 |
data.products[].attr4 | string | 自定义冗余字段 |
data.products[].attr5 | string | 自定义冗余字段 |
data.products[].attr6 | string | 自定义冗余字段 |
data.products[].attr7 | string | 自定义冗余字段 |
data.products[].attr8 | string | 自定义冗余字段 |
data.products[].attr9 | string | 自定义冗余字段 |
data.products[].attr10 | string | 自定义冗余字段 |
data.products[].colors | Array | 颜色数组对象 |
data.products[].colors[].colorId | String | 颜色级别的商品id,如果没有可以不填 |
data.products[].colors[].color | String | 颜色,可用于颜色筛选 |
data.products[].colors[].rbga | String | 颜色RGBA |
data.products[].colors[].mainImage | String | 商品白底图 |
data.products[].colors[].images | Array | 商品图片 URL 列表 |
data.products[].colors[].price | BigDecimal | 颜色级别的商品价格 |
data.products[].colors[].attr1 | String | 自定义冗余字段,会在搜索结果中返回,可用于颜色筛选 |
data.products[].colors[].attr2 | String | 自定义冗余字段,会在搜索结果中返回,可用于颜色筛选 |
data.products[].colors[].attr3 | String | 自定义冗余字段,会在搜索结果中返回,可用于颜色筛选 |
data.products[].colors[].sizes | Array | 尺码数组对象 |
data.products[].colors[].sizes[].sizeId | String | 尺码级别的商品id,如果没有可以不填 |
data.products[].colors[].sizes[].size | String | 尺码 |
data.products[].colors[].sizes[].price | BigDecimal | 颜色级别的商品价格 |
data.products[].colors[].sizes[].attr1 |