根据商品编码查询价格详情

---

接口描述

根据商品编码查询对应商品的参考价详情信息

注意：当搜索请求携带areaCode(地区编码)参数时，如果所查询的地区无参考价信息，但此地区的上级地区(市-省-国)有参考价信息，则会返回上级地区参考价信息。

例如：查询水泥 P.O 42.5、济南市的数据时,如果济南市无数据，则返回山东省的数据，如果山东省无数据，则返回全国的数据。

字符编码

UTF-8

请求地址

/openapi/price-track/price-info

请求 Header 参数

参数名	类型	必填	说明
accessToken	String	是	请求发起时需要在 header 中，携带 accessToken，获取方式详见获取 accessToken

版本号（ver）

1

请求方式

POST(application/json)

请求参数

参数名	类型	长度	必填	说明
ver	Integer	-	是	api 接口版本，参见具体 API 的版本。示例：1
goodsCode	String	32	是	商品编码，可以在商品参考价智能检索接口中获取
areaCode	String	10	是	地区编码 默认0（全国）

请求示例

{
  "ver": "1",
  "goodsCode": "000000000006AD033",
  "areaCode": "0"
}

应用级返回结果

GoodsPriceVO 商品参考价对象

参数名	类型	长度	必填	说明
goodsName	String	255	是	商品名称
goodsBrand	String	100	否	商品品牌。注：大宗商品无品牌
unit	String	255	是	单位
goodsCode	String	32	是	商品编码
areaCode	String	10	是	地区编码
categoryId	Long	-	是	商品分类ID
priceInfo	PriceInfoVO[]	-	是	价格信息数组
lastPublishTime	String	-	是	最后一次发布时间
props	GoodPropVO[]	-	否	属性数组

PriceInfoVO 价格信息对象

参数名	类型	长度	必填	说明
timeRange	String[]	200	是	时间范围：[起始日期，结束日期]
price	String	200	是	价格（价格：元）
type	Integer	-	是	类型：1-前一个月；2-前三个月；3-近半年；4-近一年；5-上周

GoodPropVO 属性对象

参数名	类型	长度	必填	说明
propName	String	200	是	属性名
propVal	String	200	是	属性值

返回结果示例

{
  "code": 200,
  "data": {
    "goodsName": "柴油 -10 Ⅵ",
    "goodsBrand": null,
    "avgPrice": "9064.4",
    "unit": "吨",
    "props": [
      {
        "propName": "牌号",
        "propVal": "-10"
      },
      {
        "propName": "标准",
        "propVal": "Ⅵ"
      }
    ],
    "goodsCode": "000000000006AD033",
    "categoryId": "3427",
    "priceInfo": [
      {
        "timeRange": [
          "2022-12-12",
          "2022-12-18"
        ],
        "price": "9064.4",
        "type": "5"
      },
      {
        "timeRange": [
          "2022-11-01",
          "2022-11-30"
        ],
        "price": "9272.52",
        "type": "1"
      },
      {
        "timeRange": [
          "2022-09-01",
          "2022-11-30"
        ],
        "price": "9000.28",
        "type": "2"
      },
      {
        "timeRange": [
          "2022-06-01",
          "2022-11-30"
        ],
        "price": "8724.36",
        "type": "3"
      },
      {
        "timeRange": [
          "2021-12-01",
          "2022-11-30"
        ],
        "price": "8268.83",
        "type": "4"
      }
    ],
    "lastPublishTime": "2022-12-19 17:33:37",
    "areaCode": "0"
  },
  "msg": "成功"
}

返回code码见 API 返回码说明