Skip to content

商品多角度图片查询

应用场景

根据商品条码查询商品的图片信息，包括 商品条码、商品名称、尺寸规格、多角度图片（正面、侧面1、侧面2、背面）。

请求参数

接口名称: product.image.get

参数名称 必填 类型 示例 说明
product_id 是 String(13) 6902022132537 商品条码，支持UPC-A、UPC-E、EAN-13、EAN-8等

xml请求示例：

<xml>
    <version>1.0.0</version>
    <charset>UTF-8</charset>
    <sign_type>MD5</sign_type>
    <appid>12012324</appid>
    <nonce_str>5K8264ILTKCH16CQ</nonce_str>
    <method>product.image.get</method>
    <product_id>6902022132537</product_id>
    <sign>D5E5397531111D35C3D7B6BCCB5B991A</sign>
</xml>

json请求示例：

{
  "version": "1.0.0",
  "charset": "UTF-8",
  "sign_type": "MD5",
  "method": "product.image.get",
  "appid": "12012324",
  "nonce_str": "5K8264ILTKCH16CQ",
  "sign": "D5E5397531111D35C3D7B6BCCB5B991A",
  "product_id": "6902022132537"
}

返回结果

参数名称 必填 类型 示例 说明
product_id 是 String(13) 6902022132537 商品条码
title 否 String(255) 蓝月亮彩色衣物色渍净清新柠檬花香600g 商品名称
dimensions 否 Object 商品尺寸对象
images 否 Object 商品图片对象

dimensions 字段说明

参数名称 必填 类型 示例 说明
width 否 String(32) 93mm 商品宽度
height 否 String(32) 249mm 商品高度
depth 否 String(32) 56mm 商品深度

images 字段说明

参数名称 必填 类型 示例 说明
front_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 正面图
side1_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 侧面图1
side2_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 侧面图2
back_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 背面图

注：当某个角度的图片不存在时，对应字段返回空字符串。

xml返回示例：

<xml>
    <product_id>6902022132537</product_id>
    <title>蓝月亮彩色衣物色渍净清新柠檬花香600g</title>
    <dimensions>{"width":"93mm","height":"249mm","depth":"56mm"}</dimensions>
    <images>{"front_image_url":"https://img0.banmahui.cn/patrol/barcode/3521c765bd105f2eb2e3bb6383f598a244ccc945.jpg","side1_image_url":"https://img0.banmahui.cn/patrol/barcode/95d7e3d5d7b4bf182717ad2ce81d3333b4ec5fa65.jpg","side2_image_url":"https://img0.banmahui.cn/patrol/barcode/42445531a9a9ee66300963e3b027d55faa9156ee.jpg","back_image_url":"https://img0.banmahui.cn/patrol/barcode/7c479d5d7b4bf182717ad2ce81d3333b4ec5fa65.jpg"}</images>
    <charset>UTF-8</charset>
    <version>1.0.0</version>
    <sign_type>MD5</sign_type>
    <nonce_str>5e96ebe2814d7</nonce_str>
    <return_code>SUCCESS</return_code>
    <result_code>SUCCESS</result_code>
    <appid>12012324</appid>
    <sign>4A317BED5450494444A8E2852BB33B45</sign>
</xml>

json返回示例：

{
  "return_code": "SUCCESS",
  "nonce_str": "FvYSnPuFFPkAr77M",
  "appid": "13682463",
  "version": "1.0.0",
  "charset": "UTF-8",
  "sign_type": "MD5",
  "sign": "63238039D6E43634297CF2A6EB5F3B72",
  "result_code": "SUCCESS",
  "product_id": "6902022132537",
  "title": "蓝月亮彩色衣物色渍净清新柠檬花香600g",
  "dimensions": {
    "width": "93mm",
    "height": "249mm",
    "depth": "56mm"
  },
  "images": {
    "front_image_url": "https://img0.banmahui.cn/patrol/barcode/3521c765bd105f2eb2e3bb6383f598a244ccc945.jpg",
    "side1_image_url": "https://img0.banmahui.cn/patrol/barcode/95d7e3d5d7b4bf182717ad2ce81d3333b4ec5fa65.jpg",
    "side2_image_url": "https://img0.banmahui.cn/patrol/barcode/42445531a9a9ee66300963e3b027d55faa9156ee.jpg",
    "back_image_url": "https://img0.banmahui.cn/patrol/barcode/7c479d5d7b4bf182717ad2ce81d3333b4ec5fa65.jpg"
  }
}