# 根据商品编码查询历史价格数据

# 接口描述

根据商品编码查询历史月价格数据与历史周价格数据。

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

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

# 字符编码

UTF-8

# 请求地址

/openapi/price-track/goods-history-price

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

# 版本号（ver）

# 请求方式

POST(application/json)

# 请求参数

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

# 请求示例

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

1
2
3
4
5

# 应用级返回结果

# GoodsHistoryPriceVO 商品历史价格数据对象

参数名	类型	长度	必填	说明
goodsName	String	255	是	商品名称
goodsBrand	String	100	否	商品品牌。注：大宗商品无品牌
unit	String	255	是	单位
goodsCode	String	32	是	商品编码
areaCode	String	10	是	地区编码
categoryId	Long	-	是	商品分类ID
props	GoodPropVO[]	-	否	属性数组
weekPriceHistory	WeekPriceHistory[]	-	否	历史周价格数据（有部分品类无周价格数据）
monthPriceHistory	MonthPriceHistory[]	-	是	过去一年每个月的价格数据

# WeekPriceHistory 价格信息对象

参数名	类型	长度	必填	说明
weekDate	String	10	是	周结束日期，格式：2022-11-13
price	String	200	是	价格（价格：元）

# MonthPriceHistory 价格信息对象

参数名	类型	长度	必填	说明
monthDate	String	6	是	月份，格式：2022-08
price	String	200	是	价格（价格：元）

# 返回结果示例

{
  "code": 200,
  "data": {
    "goodsName": "柴油",
    "goodsBrand": null,
    "unit": "吨",
    "goodsCode": "000000000006AD694",
    "areaCode": "0",
    "categoryId": "3427",
    "props": null,
    "weekPriceHistory": [
      {
        "weekDate": "2022-11-06",
        "price": "8989.87"
      },
      {
        "weekDate": "2022-11-13",
        "price": "9067.97"
      },
      {
        "weekDate": "2022-11-20",
        "price": "9071.11"
      },
      {
        "weekDate": "2022-11-27",
        "price": "9094.8"
      },
      {
        "weekDate": "2022-12-04",
        "price": "9165.91"
      },
      {
        "weekDate": "2022-12-11",
        "price": "8637.02"
      },
      {
        "weekDate": "2022-12-18",
        "price": "8771.66"
      }
    ],
    "monthPriceHistory": [
      {
        "monthDate": "2021-12",
        "price": "7293.06"
      },
      {
        "monthDate": "2022-01",
        "price": "7181.82"
      },
      {
        "monthDate": "2022-02",
        "price": "7559.1"
      },
      {
        "monthDate": "2022-03",
        "price": "8269.77"
      },
      {
        "monthDate": "2022-04",
        "price": "8510.11"
      },
      {
        "monthDate": "2022-05",
        "price": "8677.01"
      },
      {
        "monthDate": "2022-06",
        "price": "9012.77"
      },
      {
        "monthDate": "2022-07",
        "price": "8511.62"
      },
      {
        "monthDate": "2022-08",
        "price": "8606.47"
      },
      {
        "monthDate": "2022-09",
        "price": "8912.87"
      },
      {
        "monthDate": "2022-10",
        "price": "8904.59"
      },
      {
        "monthDate": "2022-11",
        "price": "9029.48"
      }
    ]
  },
  "msg": "成功"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

返回code码见 API 返回码说明