1. 商品
西之月开放接口(openapi)
  • 西之月开放平台介绍
  • 西之月接入流程
  • 西之月开放API
  • 西之月订阅通知
  • 公共错误码
  • 货盘页面接入说明
  • openapi
    • 商品
      • 📖商品能力
      • SKU
        • SKU列表
        • SKU信息
        • SKU信息及价格
        • SKU查询客户价格
        • SKU查询英代欧代美代协议
        • SKU一体化标签
        • SKU一体化标签平台
        • SKU证书
        • SKU六面图
        • SKU商品图包
        • SKU视频
        • SKU商品标签【国内】
        • SKU产品文案
        • SKU实拍图附带一体化标签
        • SKU图包资料
      • 库存
        • 商品总库存列表
        • 商品分仓库存列表
        • 指定商品分仓库存
        • 圈货、备货库存查询
        • SKU实时库存【国内】
      • 商品列表
        GET
      • 商品详情
        GET
      • 商品价格
        POST
      • 个性化商品价格列表
        POST
      • 商品所有档位价格
        POST
      • 商品分类
        GET
      • 商品分类-获取子分类
        GET
      • 商品品牌
        GET
      • 商品证书
        GET
      • 商品使用说明书
        GET
    • 订单
      • 📖订单能力
      • 交接单
        • 交接单列表
        • 验证订单允许上传交接单
        • 上传交接单文件
        • 保存交接单
      • 创建订单
      • 订单预计算
      • 订单列表
      • 订单详情
      • 订单详情列表
      • 订单取消
      • 订单状态
      • 订单支付状态
      • 订单物流轨迹
    • 支付
      • 📖支付能力
      • 订单支付页面
      • 发起支付
      • 获取支付方式
      • 获取订单支付信息
    • 售后
      • 📖售后能力
      • 获取发起售后配置数据
      • 订单发起售后
      • 撤销售后
    • 账期
      • 📖账期能力
      • 已结清账期-账单列表
      • 未结清账期-账单列表
      • 未结清账单-销售订单列表
      • 未结清账单-售后订单列表
    • 品牌授权
      • 📖品牌授权能力
      • 获取授权平台列表
      • 获取模板类型列表
      • 获取授权品牌列表
      • 获取执照列表信息
      • 品牌授权申请
      • 品牌授权记录
      • 品牌授权作废
    • 其他
      • 📖其它能力
      • 仓库
        • 仓库列表信息
        • 发货区域列表
      • 物流
        • 物流公司列表
        • 获取运费接口
      • 平台
        • 获取授权码
        • 平台列表信息-新
        • 平台列表信息
      • 用户
        • 根据token获取用户信息
    • 订阅通知
      • 商品信息变更
      • 商品上下架状态变更
      • 商品库存变更
      • 商品价格变更
      • 商品删除
  1. 商品

商品分类-获取子分类

外部-测试环境
https://testing.westmonth.com
外部-测试环境
https://testing.westmonth.com
GET
/openapi/productCategory/getCategoryChildren

商品分类-获取子分类接口#

提供获取商品子分类的能力,支持根据父级分类ID获取对应的子分类信息,也可获取顶级分类。

适用场景#

获取指定父分类下的子分类
获取顶级商品分类

接口类型#

GET

请求频率限制#

默认频率:以平台配额为准

请求说明#

请求URL
正式环境:https://www.westmonth.com/openapi/productCategory/getCategoryChildren
测试环境:https://testing.westmonth.com/openapi/productCategory/getCategoryChildren

请求参数#

Header参数#

参数名类型必填示例值说明
Authorizationstring是authorization身份验证Token
Content-Typestring是application/json建议固定传此值

Query参数#

参数名类型必填默认值可选值说明
parentIdstring否0-父级id,不传为0,获取顶级分类
localestring否zh_cnzh_cn、en语言类型,默认中文

响应字段说明#

成功响应(HTTP 200)
根 字段
字段类型说明
statusstring状态标识(success表示成功,其他表示失败)
messagestring提示信息
dataarray业务数据,包含子分类列表
data数组 字段
字段类型说明
idinteger分类ID
parent_idinteger父级分类ID
iconstring分类icon图片URL
change_iconstring变化状态下的icon图片URL
imagestring分类图片URL
image_urlstring图片跳转路由
positioninteger排序序号,用于分类展示排序
descriptionobject产品分类名称、描述等详情信息
description对象 字段
字段类型说明
idinteger描述信息ID
category_idinteger所属分类ID
localestring语言类型
namestring分类名称
contentstring分类内容描述
meta_titlestring元标题
meta_descriptionstring元描述
meta_keywordsstring元关键词
created_atstring创建时间
updated_atstring更新时间

调用示例#

URL请求#

请求示例#

成功返回示例#

{
    "status": "success",
    "message": "success",
    "data": [
        {
            "id": 100121,
            "parent_id": 0,
            "icon": "https://oss.westmonth.com/catalog/cosmetics/slices-icon/17252580218_美容护理.svg",
            "change_icon": "https://oss.westmonth.com/catalog/cosmetics/slices-icon/172525802155_美容护理hover.svg",
            "image": "https://oss.westmonth.com/catalog/cosmetics/导航banner/170453620350_导航banner.png",
            "image_url": "",
            "position": 99,
            "description": {
                "id": 994,
                "category_id": 100121,
                "locale": "zh_cn",
                "name": "美容护理",
                "content": "美容护理",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-02 14:21:29",
                "updated_at": "2024-09-02 14:21:29"
            }
        }
    ]
}

失败返回示例#

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理#

公共错误码
HTTP status code错误码错误信息描述

常见问题#

Q1:如何获取顶级分类?#

A:不传递parentId参数,或parentId参数值为0,即可获取顶级分类。

Q2:如何获取其他语言的分类信息?#

A:通过设置locale参数为en,可获取英文的分类信息,默认是中文(zh_cn)。

版本历史#

版本日期修改说明
v1.02025-01-10初始版本

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://testing.westmonth.com/openapi/productCategory/getCategoryChildren?parentId=0&locale=zh_cn' \
--header 'Authorization: {{token}}' \
--header 'Cookie: {{cookie}};{{cookie}}' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "status": "success",
    "message": "success",
    "data": [
        {
            "id": 100121,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/17252580218_美容护理.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802155_美容护理hover.svg",
            "image": "https://catalog/17274191047_16美容护理.png",
            "image_url": "",
            "position": 99,
            "description": {
                "id": 1062,
                "category_id": 100121,
                "locale": "zh_cn",
                "name": "美容护理",
                "content": "美容护理",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-27 14:39:12",
                "updated_at": "2024-09-27 14:39:12"
            }
        },
        {
            "id": 100122,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802164_头部护理与造型.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802119_头部护理与造型hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620398_导航banner2.png",
            "image_url": "",
            "position": 98,
            "description": {
                "id": 1064,
                "category_id": 100122,
                "locale": "zh_cn",
                "name": "头部护理与造型",
                "content": "头部护理与造型",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:46:03",
                "updated_at": "2024-09-28 09:46:03"
            }
        },
        {
            "id": 100123,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802188_美妆香水.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802120_美妆香水hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620429_导航banner3.png",
            "image_url": "",
            "position": 97,
            "description": {
                "id": 1066,
                "category_id": 100123,
                "locale": "zh_cn",
                "name": "美妆香水",
                "content": "美妆香水",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:46:45",
                "updated_at": "2024-09-28 09:46:45"
            }
        },
        {
            "id": 100124,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802143_口腔护理.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802115_口腔护理hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620478_导航banner4.png",
            "image_url": "",
            "position": 96,
            "description": {
                "id": 1068,
                "category_id": 100124,
                "locale": "zh_cn",
                "name": "口腔护理",
                "content": "口腔护理",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:47:03",
                "updated_at": "2024-09-28 09:47:03"
            }
        },
        {
            "id": 100125,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/17252580211_男士护理.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802159_男士护理hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620413_导航banner5.png",
            "image_url": "",
            "position": 95,
            "description": {
                "id": 1070,
                "category_id": 100125,
                "locale": "zh_cn",
                "name": "男士护理",
                "content": "男士护理",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:47:20",
                "updated_at": "2024-09-28 09:47:20"
            }
        },
        {
            "id": 100126,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802159_健康护理.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802175_健康护理hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620412_导航banner6.png",
            "image_url": "",
            "position": 94,
            "description": {
                "id": 1072,
                "category_id": 100126,
                "locale": "zh_cn",
                "name": "健康护理",
                "content": "健康护理",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:47:50",
                "updated_at": "2024-09-28 09:47:50"
            }
        },
        {
            "id": 100128,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802147_成人保健.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802117_成人保健hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620437_导航banner7.png",
            "image_url": "",
            "position": 94,
            "description": {
                "id": 1074,
                "category_id": 100128,
                "locale": "zh_cn",
                "name": "成人保健",
                "content": "成人保健",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:48:11",
                "updated_at": "2024-09-28 09:48:11"
            }
        },
        {
            "id": 100349,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802183_食品.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802160_食品hover.svg",
            "image": "https://catalog/cosmetics/导航banner/172285226662_食品.jpg",
            "image_url": "",
            "position": 94,
            "description": {
                "id": 1024,
                "category_id": 100349,
                "locale": "zh_cn",
                "name": "食品",
                "content": "食品",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-02 14:29:15",
                "updated_at": "2024-09-02 14:29:15"
            }
        },
        {
            "id": 100129,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802196_庭院、草坪与园艺.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802170_庭院、草坪与园艺hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620464_导航banner8.png",
            "image_url": "",
            "position": 93,
            "description": {
                "id": 1076,
                "category_id": 100129,
                "locale": "zh_cn",
                "name": "庭院、草坪与园艺",
                "content": "庭院、草坪与园艺",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:49:36",
                "updated_at": "2024-09-28 09:49:36"
            }
        },
        {
            "id": 100130,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802110_家居用品.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802131_家居用品hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620485_导航banner9.png",
            "image_url": "",
            "position": 92,
            "description": {
                "id": 1078,
                "category_id": 100130,
                "locale": "zh_cn",
                "name": "家居用品",
                "content": "家居用品",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:50:56",
                "updated_at": "2024-09-28 09:50:56"
            }
        },
        {
            "id": 100133,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802196_汽车用品.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802115_汽车用品hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620499_导航banner12.png",
            "image_url": "",
            "position": 91,
            "description": {
                "id": 1084,
                "category_id": 100133,
                "locale": "zh_cn",
                "name": "汽车用品",
                "content": "汽车用品",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:51:43",
                "updated_at": "2024-09-28 09:51:43"
            }
        },
        {
            "id": 100134,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802151_玩具.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802129_玩具hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620498_导航banner13.png",
            "image_url": "",
            "position": 90,
            "description": {
                "id": 1086,
                "category_id": 100134,
                "locale": "zh_cn",
                "name": "玩具",
                "content": "玩具",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:52:02",
                "updated_at": "2024-09-28 09:52:02"
            }
        },
        {
            "id": 100348,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525912754_服饰.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525912744_服饰hover.svg",
            "image": "https://catalog/cosmetics/导航banner/172267416125_服饰.jpg",
            "image_url": "",
            "position": 89,
            "description": {
                "id": 1026,
                "category_id": 100348,
                "locale": "zh_cn",
                "name": "服饰",
                "content": "服饰",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-02 14:38:57",
                "updated_at": "2024-09-02 14:38:57"
            }
        },
        {
            "id": 100347,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802186_饰品.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802192_饰品hover.svg",
            "image": "https://catalog/cosmetics/导航banner/172267416136_配饰.jpg",
            "image_url": "",
            "position": 88,
            "description": {
                "id": 1020,
                "category_id": 100347,
                "locale": "zh_cn",
                "name": "饰品",
                "content": "饰品",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-02 14:28:37",
                "updated_at": "2024-09-02 14:28:37"
            }
        },
        {
            "id": 100131,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802135_节日气氛.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802158_节日气氛hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620487_导航banner10.png",
            "image_url": "",
            "position": 87,
            "description": {
                "id": 1080,
                "category_id": 100131,
                "locale": "zh_cn",
                "name": "节日气氛",
                "content": "节日气氛",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:51:11",
                "updated_at": "2024-09-28 09:51:11"
            }
        },
        {
            "id": 100132,
            "parent_id": 0,
            "icon": "https://catalog/cosmetics/slices-icon/172525802176_宠物用品.svg",
            "change_icon": "https://catalog/cosmetics/slices-icon/172525802152_宠物用品hover.svg",
            "image": "https://catalog/cosmetics/导航banner/170453620459_导航banner11.png",
            "image_url": "",
            "position": 86,
            "description": {
                "id": 1082,
                "category_id": 100132,
                "locale": "zh_cn",
                "name": "宠物用品",
                "content": "宠物用品",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-28 09:51:25",
                "updated_at": "2024-09-28 09:51:25"
            }
        },
        {
            "id": 100397,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1028,
                "category_id": 100397,
                "locale": "zh_cn",
                "name": "背带裤",
                "content": "",
                "meta_title": "",
                "meta_description": "背带裤",
                "meta_keywords": "背带裤",
                "created_at": "2024-09-14 14:29:53",
                "updated_at": "2024-09-14 14:29:53"
            }
        },
        {
            "id": 100398,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1030,
                "category_id": 100398,
                "locale": "zh_cn",
                "name": "ikun",
                "content": "ikun",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-14 14:30:10",
                "updated_at": "2024-09-14 14:30:10"
            }
        },
        {
            "id": 100399,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1032,
                "category_id": 100399,
                "locale": "zh_cn",
                "name": "食用油",
                "content": "食用油",
                "meta_title": "",
                "meta_description": "",
                "meta_keywords": "",
                "created_at": "2024-09-14 14:33:52",
                "updated_at": "2024-09-14 14:33:52"
            }
        },
        {
            "id": 100400,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1034,
                "category_id": 100400,
                "locale": "zh_cn",
                "name": "蔬菜",
                "content": "蔬菜",
                "meta_title": "蔬菜",
                "meta_description": "蔬菜",
                "meta_keywords": "蔬菜",
                "created_at": "2024-09-14 14:34:06",
                "updated_at": "2024-09-14 14:34:06"
            }
        },
        {
            "id": 100401,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1036,
                "category_id": 100401,
                "locale": "zh_cn",
                "name": "生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜",
                "content": "",
                "meta_title": "生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜",
                "meta_description": "生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜",
                "meta_keywords": "生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜生鲜",
                "created_at": "2024-09-14 14:34:28",
                "updated_at": "2024-09-14 14:34:28"
            }
        },
        {
            "id": 100402,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1038,
                "category_id": 100402,
                "locale": "zh_cn",
                "name": "运动用品",
                "content": "运动用品",
                "meta_title": "运动用品",
                "meta_description": "运动用品运动用品",
                "meta_keywords": "运动用品",
                "created_at": "2024-09-14 14:35:20",
                "updated_at": "2024-09-14 14:35:20"
            }
        },
        {
            "id": 100403,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1098,
                "category_id": 100403,
                "locale": "zh_cn",
                "name": "远方",
                "content": "哈哈哈",
                "meta_title": "速食食品",
                "meta_description": "速食食品",
                "meta_keywords": "速食食品",
                "created_at": "2025-03-21 15:07:16",
                "updated_at": "2025-03-21 15:07:16"
            }
        },
        {
            "id": 100404,
            "parent_id": 0,
            "icon": "",
            "change_icon": "",
            "image": "",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1094,
                "category_id": 100404,
                "locale": "zh_cn",
                "name": "3C 3C3C3C3C3C3C3C",
                "content": "3C3C3C3C3C3C3C3C3C",
                "meta_title": "3C",
                "meta_description": "3C3C",
                "meta_keywords": "3C",
                "created_at": "2025-03-13 17:20:36",
                "updated_at": "2025-03-13 17:20:36"
            }
        },
        {
            "id": 100225,
            "parent_id": 0,
            "icon": "https://catalog/平台Logo/平台爆款lazada.png",
            "change_icon": "https://catalog/平台Logo/平台爆款aliexpress.png",
            "image": "https://catalog/平台Logo/1.jpg",
            "image_url": "",
            "position": 0,
            "description": {
                "id": 1058,
                "category_id": 100225,
                "locale": "zh_cn",
                "name": "面部美容护理",
                "content": "面部美容护理",
                "meta_title": "我是测试得",
                "meta_description": "测试",
                "meta_keywords": "测试来的",
                "created_at": "2024-09-26 15:56:58",
                "updated_at": "2024-09-26 15:56:58"
            }
        }
    ]
}
修改于 2026-02-24 03:18:21
上一页
商品分类
下一页
商品品牌
Built with