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

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

适用场景

获取指定父分类下的子分类

获取顶级商品分类

接口类型

GET

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Query参数

参数名	类型	必填	默认值	可选值	说明
parentId	string	否	0	-	父级id，不传为0，获取顶级分类
locale	string	否	zh_cn	zh_cn、en	语言类型，默认中文

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
status	string	状态标识（success表示成功，其他表示失败）
message	string	提示信息
data	array	业务数据，包含子分类列表

data数组字段

字段	类型	说明
id	integer	分类ID
parent_id	integer	父级分类ID
icon	string	分类icon图片URL
change_icon	string	变化状态下的icon图片URL
image	string	分类图片URL
image_url	string	图片跳转路由
position	integer	排序序号，用于分类展示排序
description	object	产品分类名称、描述等详情信息

description对象字段

字段	类型	说明
id	integer	描述信息ID
category_id	integer	所属分类ID
locale	string	语言类型
name	string	分类名称
content	string	分类内容描述
meta_title	string	元标题
meta_description	string	元描述
meta_keywords	string	元关键词
created_at	string	创建时间
updated_at	string	更新时间

调用示例

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.0	2025-01-10	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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"
            }
        }
    ]
}

商品分类-获取子分类

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

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Query参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如何获取顶级分类？#

Q2：如何获取其他语言的分类信息？#

版本历史#

请求参数

请求示例代码

返回响应

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

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Query参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何获取顶级分类？

Q2：如何获取其他语言的分类信息？

版本历史