Skip to content

棚格图商品图片查询

应用场景

根据商品条码查询商品的图片信息，包括商品基础信息、尺寸规格、多角度图片（0°、90°、180°、270°）。适用于货架棚格图构建场景。

请求参数

接口名称: 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 商品尺寸对象
angles 否 Object 多角度图片对象

dimensions 字段说明

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

angles 字段说明

参数名称 必填 类型 示例 说明
angle_0_image_url 否 String(255) https://img1.banmahui.cn/1/pimg/x800_v1/sym/... 0度正面图
angle_90_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 90度侧面图
angle_180_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 180度背面图
angle_270_image_url 否 String(255) https://img0.banmahui.cn/patrol/barcode/... 270度侧面图

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

xml返回示例：

<xml>
    <product_id>6902022132537</product_id>
    <title>蓝月亮彩色衣物色渍净清新柠檬花香600g</title>
    <dimensions>{"width":"93mm","height":"249mm","depth":"56mm"}</dimensions>
    <angles>{"angle_0_image_url":"https://img1.banmahui.cn/1/pimg/x800_v1/sym/6902022132537-76d86eff1a8f515af07f50a3d54e864d.jpg","angle_90_image_url":"https://img0.banmahui.cn/patrol/barcode/3521c765bd105f2eb2e3bb6383f598a244ccc945.jpg","angle_180_image_url":"https://img0.banmahui.cn/patrol/barcode/7c479d5d7b4bf182717ad2ce81d3333b4ec5fa65.jpg","angle_270_image_url":"https://img0.banmahui.cn/patrol/barcode/42445531a9a9ee66300963e3b027d55faa9156ee.jpg"}</angles>
    <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"
  },
  "angles": {
    "angle_0_image_url": "https://img1.banmahui.cn/1/pimg/x800_v1/sym/6902022132537-76d86eff1a8f515af07f50a3d54e864d.jpg",
    "angle_90_image_url": "https://img0.banmahui.cn/patrol/barcode/3521c765bd105f2eb2e3bb6383f598a244ccc945.jpg",
    "angle_180_image_url": "https://img0.banmahui.cn/patrol/barcode/7c479d5d7b4bf182717ad2ce81d3333b4ec5fa65.jpg",
    "angle_270_image_url": "https://img0.banmahui.cn/patrol/barcode/42445531a9a9ee66300963e3b027d55faa9156ee.jpg"
  }
}