京东按图搜索京东商品(拍立淘) API 返回值说明
京东的按图搜索(拍立淘)API允许用户通过上传图片来搜索相似的京东商品。API的返回值通常包含了搜索到的商品列表及其相关信息。具体的返回值可能因API版本、请求参数的不同而有所差异。以下是一个典型的按图搜索API返回值的示例和说明:
```json
{
"status": "success",
"code": 200,
"message": "请求成功",
"request_id": "请求的唯一标识符",
"result": {
"total": 10, // 搜索结果总数
"items": [
{
"product_id": "商品ID",
"product_name": "商品名称",
"image_url": "商品主图URL",
"price": "商品价格",
"sale_price": "促销价格",
"score": "相似度评分",
"sku_id": "商品规格ID",
"stock": "库存数量",
"category_name": "商品分类名称",
"shop_name": "店铺名称",
"short_description": "商品短描述"
// 其他可能的字段,如评价数、销量等
},
{
// 其他商品信息...
}
]
}
}
```
返回值说明:
- `status`:请求状态,通常为"success"表示请求成功。
- `code`:状态码,通常为200表示请求成功。
- `message`:返回消息,用于描述请求结果,如"请求成功"。
- `request_id`:请求的唯一标识符,用于追踪和调试请求。
- `result`:搜索结果对象,包含了商品列表和相关信息。
`result`对象中的字段说明:
- `total`:搜索结果的总数。
- `items`:搜索到的商品列表,每个商品都是一个对象。
每个商品信息对象(`items`数组中的元素)包含以下字段:
- `product_id`:商品ID,唯一标识商品的编号。
- `product_name`:商品名称,商品的标题。
- `image_url`:商品主图URL,商品的图片链接地址。
- `price`:商品价格,商品的原价。
- `sale_price`:促销价格,商品当前的促销价。
- `score`:相似度评分,表示上传的图片与搜索到商品的相似度。
- `sku_id`:商品规格ID,唯一标识商品规格的编号。
- `stock`:库存数量,商品的库存信息。
- `category_name`:商品分类名称,商品所属的分类。
- `shop_name`:店铺名称,销售该商品的店铺名称。
- `short_description`:商品短描述,商品的简短描述信息。
请注意,上述示例仅供参考,实际的API返回值可能因API版本、请求参数的不同而有所差异。为了获取准确的返回值说明和字段定义,建议查阅京东的官方文档或API接口文档。同时,实际使用时还需要考虑API的调用限制、错误处理等因素,获取API调用详情数据。