京东按图搜索京东商品(拍立淘) API 返回值说明

97 阅读2分钟

京东的按图搜索(拍立淘)API允许用户通过上传图片来搜索相似的京东商品。API的返回值通常包含了搜索到的商品列表及其相关信息。具体的返回值可能因API版本、请求参数的不同而有所差异。以下是一个典型的按图搜索API返回值的示例和说明:

{
  "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调用详情WT:TBapi99