产品分类

2025/10/12大约 4 分钟

产品分类

创建产品分类

POST	/admin-api/iot/product-cate/create

请求数据类型：application/json;charset=UTF-8

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
name	产品品类名称	json	true	string
identifier	产品品类标识，推荐：英文和数字组合，以英文或下划线开头	json	true	string
sortOrder	排序	json	true	string
description	描述	json	false	string
parentId	父id	json	false	long
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	创建成功返回产品品类Id	long
msg	状态消息	string

响应示例

{
  "status": 0,
  "code": 0,
  "data": 1419193028976640,
  "msg": ""
}

获取产品分类列表

GET	/admin-api/iot/product-cate/list

请求数据类型：application/json;charset=UTF-8

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
name	产品品类名称，用于过滤name的产品品类	query	false	string
identifier	产品品类标识，用于过滤identifier的产品品类	query	false	string
description	描述，模糊搜索description内容	query	false	string
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	查询成功后返回数据列表	array
---id	产品分类id	long
---name	产品品类名称	string
---identifier	产品品类标识	string
---sortOrder	排序	int32
---description	描述	string
---parentId	父id	long
---createTime	创建时间，时间戳	long
msg	状态消息	string

响应示例

{
    "status": 0,
    "code": 0,
    "data": [
        {
            "name": "ADADA",
            "identifier": "DADWA",
            "sortOrder": 1,
            "description": null,
            "parentId": 0,
            "id": 1419193028911640,
            "createTime": 1732413365000
        },
        {
            "name": "test",
            "identifier": "test",
            "sortOrder": 22,
            "description": null,
            "parentId": 0,
            "id": 1419192349728768,
            "createTime": 1732412226000
        },
        {
            "name": "远程控制继电器类",
            "identifier": "remote_relay",
            "sortOrder": 3,
            "description": "wifi\\4g远程控制继电器类",
            "parentId": 0,
            "id": 1390387009978368,
            "createTime": 1697249768000
        },
        {
            "name": "智能家具",
            "identifier": "remoteCard",
            "sortOrder": 3,
            "description": null,
            "parentId": 0,
            "id": 1366004557963264,
            "createTime": 1667422033000
        }
    ],
    "msg": ""
}

获取产品分类

GET	/admin-api/iot/product-cate/get

请求数据类型：application/json;charset=UTF-8

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
id	产品品类id	query	true	long
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	获取返回的对象	object
---id	产品分类id	long
---name	产品品类名称	string
---identifier	产品品类标识	string
---sortOrder	排序	int32
---description	描述	string
---parentId	父id	long
---createTime	创建时间，时间戳	long
msg	状态消息	string

响应示例

{
    "status": 0,
    "code": 0,
    "data": {
            "name": "智能家具",
            "identifier": "remoteCard",
            "sortOrder": 3,
            "description": null,
            "parentId": 0,
            "id": 1366004557963264,
            "createTime": 1667422033000
     },
    "msg": ""
}

更新产品分类

PUT	/admin-api/iot/product-cate/update

请求数据类型：application/json;charset=UTF-8

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
id	要更新的品类id	json	true	long
name	产品品类名称	json	false	string
identifier	产品品类标识，推荐：英文和数字组合，以英文或下划线开头	json	false	string
sortOrder	排序	json	false	string
description	描述	json	false	string
parentId	父id	json	false	long
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	更新成功返回true	boolean
msg	状态消息	string

响应示例

{
  "status": 0,
  "code": 0,
  "data": true,
  "msg": ""
}

删除产品分类

DELETE	/admin-api/iot/product-cate/delete

请求数据类型：application/json;charset=UTF-8

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
id	要删除的品类id	json	true	long
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	删除成功返回true	boolean
msg	状态消息	string

响应示例

{
  "status": 0,
  "code": 0,
  "data": true,
  "msg": ""
}