# 获取商品分类配置
# 接口描述
由于商品分类会随着商品的增加不定时会产生变化，商品分类变更后，商品分类版本号会根据发布时间戳更新。
建议每天调用一次本接口，根据version判断商品分类是否有变化，
如有变化则可以通过商品分类文件下载地址下载商品分类配置数据。
商品分类配置数据下载后是 CSV 格式，字符集编码为 UTF-8。
CSV 文件的 header 依次为：
id： 分类ID
name：分类名称
parentId：父级分类ID（最顶级父级分类ID为 0）
level：分类层级
sort：排序
hasData：此分类下是否有商品数据
status：分类状态：1-生效中；0-未生效
goodsType：商品类别：1-大宗商品；2-工业品；3-办公用品
# 字符编码
UTF-8
# 请求地址
/openapi/price-track/category-notification
# 请求 Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| accessToken | String | 是 | 请求发起时需要在 header 中，携带 accessToken，获取方式详见获取 accessToken |
# 版本号（ver）
1
# 请求方式
POST(application/json)
# 请求参数
| 参数名 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| ver | Integer | - | 是 | api 接口版本，参见具体 API 的版本。示例：1 |
| version | Long | - | 否 | 商品分类版本，非必填，不传此参数默认取最新版本。 |
# 请求示例
{
"ver": 1
}
1
2
3
2
3
# 应用级返回结果
| 参数名 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| version | Long | - | 是 | 商品分类版本 |
| downloadPath | String | 300 | 是 | 商品分类文件下载地址 |
注意：此版本 dataScope: 0-全部 及 2-已删除属于预留值
# 返回结果示例
{
"code": 200,
"data": {
"version": "1670217520730",
"downloadPath": "https://static-xyxj.cneptp.com/upload/category/goods_category_v1670217520730.csv"
},
"msg": "成功"
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
返回code码见 API 返回码说明