获取技能列表
更新时间：2026-11-13
GET
https://api.dumate.cn/api/dma/v1/skills?source=custom&limit=2
本接口用于分页查询技能（Skill）列表，支持按来源筛选。
返回结果按页码分页：page 从 1 开始，默认 1；data 为当前页的技能列表，next_page 为字符串形式的下一页页码；没有下一页时为 null。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
limit
integer
每页条数，默认 20，取值 1–1000。
超出范围时返回 400。
可选
page
string
页码，从 1 开始，默认 1。
可选
source
string
按来源筛选。
可选值：custom（只看用户自建）、official（只看平台预置）；传入其他取值时返回 400。
可选
请求结构
GET /api/dma/v1/skills?source=custom&limit=2 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
请求示例
curl --location --request GET "https://api.dumate.cn/api/dma/v1/skills?source=custom&limit=2" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
技能（Skill）列表。
可选
显示子属性
隐藏子属性
items
object {7}
显示子属性
隐藏子属性
type
string
资源类型标识，固定为 skill。
可选
id
string
技能（Skill）标识。
可选
display_name
string
显示名称。
可选
source
object {1}
技能来源。
可选
显示子属性
隐藏子属性
type
string
技能来源。
可选值：custom（用户自建）、official（平台预置）。
可选
latest_version_id
string
最新版本的标识。
可选
created_at
string
创建时间，RFC 3339 格式，UTC。
可选
updated_at
string
最近更新时间，RFC 3339 格式，UTC。
可选
next_page
string
字符串形式的下一页页码；没有下一页时为 null。
可选
响应示例
{
"data": [
{
"id": "3054bd77-53c4-4372-721d-d6215d3ff4e5",
"type": "skill",
"display_name": "doc-test-skill",
"latest_version_id": "aa3c4c4c-38ea-4323-81f8-b32eb1f899b4",
"source": {
"type": "custom"
},
"created_at": "2026-11-11T06:52:37Z",
"updated_at": "2026-11-11T06:52:37Z"
},
{
"id": "69d5ff62-9980-4454-7f1d-2d807c195cf4",
"type": "skill",
"display_name": "demo-skill",
"latest_version_id": "b7a3a59c-fb76-49f1-9b26-170cd2bf2f09",
"source": {
"type": "custom"
},
"created_at": "2026-11-11T05:53:34Z",
"updated_at": "2026-11-11T05:53:35Z"
}
],
"next_page": "2"
}评价此篇文章