获取当前账户下所有 Skill 的列表,支持分页。
GET /api/v1/cloud/skills
获取当前账户下所有 Skill 的列表,支持分页。
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
limit | integer | 否 | 每页返回数量上限。默认 20,范围 1-100。超过 100 返回 400 invalid_request_error |
page | string | 否 | 向后翻页游标;使用上一页响应的 next_page 值 |
source | string | 否 | 按来源过滤,可选值:custom、qoder |
display_title | string | 否 | 按展示标题前缀搜索,不区分大小写 |
name | string | 否 | ⚠️ 已废弃:按展示标题前缀搜索的旧别名(替代:display_title) |
after_id | string | 否 | ⚠️ 已废弃:返回此 ID 之后的记录(替代:page) |
before_id | string | 否 | ⚠️ 已废弃:返回此 ID 之前的记录(替代:page) |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data | array | Skill 对象数组 |
has_more | boolean | 是否还有更多记录(true 时使用 next_page 作为下一页的 page 值) |
next_page | string | null | 下一页向后游标;has_more 为 true 时传给 page |
first_id | string | null | ⚠️ 已废弃:当前页第一条记录 ID(替代:使用 has_more/next_page 翻页) |
last_id | string | null | ⚠️ 已废弃:当前页最后一条记录 ID(替代:使用 has_more/next_page 翻页) |
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | limit 或 source 非法,或同时传入多个 page、before_id、after_id |
| 401 | authentication_error | 缺少或无效的认证令牌 |