分页查询自定义和官方 Skill,支持按来源和关键词筛选。
接口
GET /api/v1/skills
分页查询自定义和官方 Skill。
Query 参数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| type | string | — | OFFICIAL 或 CUSTOMER,区分大小写;不传时同时查询两类 |
| keywords | string | — | 关键词,去除首尾空白后为空则忽略 |
| pageNo | integer | 1 | 页码,最小 1 |
| pageSize | integer | 20 | 单页条数,取值范围 1 到 100 |
type=OFFICIAL:仅返回未删除且active的官方 Skill。type=CUSTOMER:返回主账号和工作空间下未删除的自定义 Skill,包含checking和rejected状态。- 不传
type:一次返回官方和自定义两类 Skill,total为两类合计。
响应
data 为分页对象,items 每项为 SkillDTO。
| 字段 | 类型 | 说明 |
|---|---|---|
| items | array<SkillDTO> | 当前页 Skill 列表 |
| total | long | 命中总数 |
| page_no | integer | 当前页码 |
| page_size | integer | 单页条数 |
items 为空数组,total 为 0。
示例
列表数据异步更新。新建、删除或状态变化后,列表可能短暂未反映最新状态;以获取 Skill的结果为准。
错误
| HTTP 状态码 | error_code | 说明 |
|---|---|---|
| 401 | WORKSPACE_ID_ILLEGAL | 身份信息缺失或无效 |
| 400 | INVALID_PARAMETER | type 不是 OFFICIAL 或 CUSTOMER;pageNo 或 pageSize 非整数、越界或超出分页范围 |
| 500 | SYSTEM_ERROR | 查询失败或服务内部错误 |