浏览官方模板库的场景和行业分类
浏览官方模板库的系统场景和行业分类,返回 category_id 及 children 层级。只读;这里的分类不是账号内的分区或目录。
请求
text
POST https://open.cli.im/api/v2/rpc/gallery/categories| 项目 | 要求 |
|---|---|
| 最低权限 | 只读,见权限档位 |
| 需要的 scope | templates.read |
| 组织 Key | 不能调用,返回 403 credential_type_not_allowed,见历史组织 Key |
请求参数
没有参数,请求体传 {}。
请求示例
示例里的 ID、幂等键等换成实际值。
bash
curl -sS -X POST 'https://open.cli.im/api/v2/rpc/gallery/categories' \
-H "Authorization: Bearer ${CAOLIAO_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{}'响应
成功时 HTTP 状态码为 200,顶层 code 为 0,结果在 data 里。失败时的返回见错误码与调用额度和业务错误码。
| 字段 | 类型 | 一定返回 | 说明 |
|---|---|---|---|
data.categories | object[] | 是 | 分类树 |
data.categories[].category_id | string | 是 | 分类 ID |
data.categories[].name | string | 是 | 分类名称 |
data.categories[].type | string | 是 | scene 场景;industry 行业。可选值:scene、industry |
data.categories[].children | any[] | 是 | 子分类 |
响应示例
json
{
"code": 0,
"message": "ok",
"data": {
"categories": [
{
"category_id": "12",
"name": "设备管理",
"type": "scene",
"children": [
{
"category_id": "1203",
"name": "设备巡检",
"type": "scene",
"children": []
}
]
}
]
}
}常见错误
GALLERY_QUERY_UNAVAILABLE。含义和处理方式见业务错误码。
本页由 openapi.json 生成。全部接口见接口清单。