Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/skills/{skill_id}
根据 ID 获取单个 Skill 的详细信息。
请求头
| 头部 | 必选 | 说明 |
|---|
Authorization | 是 | Bearer <PAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|
skill_id | string | 是 | Skill 的唯一标识符 |
示例请求
curl -X GET "https://openapi.qoder.sh/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d" \
-H "Authorization: Bearer $QODER_PAT"
示例响应
HTTP 200 OK
{
"id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"type": "skill",
"name": "test-skill-api-doc",
"description": "A test skill for API documentation",
"skill_type": "custom",
"status": "active",
"version": 1,
"content_size": 309,
"content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
"metadata": {},
"created_at": "2026-05-18T15:35:24.248164Z",
"updated_at": "2026-05-18T15:35:24.248164Z"
}
响应字段
| 字段 | 类型 | 说明 |
|---|
id | string | Skill 唯一标识符(skill_ 前缀) |
type | string | 资源类型,固定为 "skill" |
name | string | Skill 名称 |
description | string | Skill 描述 |
skill_type | string | Skill 类型:custom 或 prebuilt |
status | string | 状态:active 或 deleted |
version | integer | 当前版本号 |
content_size | integer | zip 文件内容大小(字节) |
content_sha256 | string | 内容的 SHA-256 哈希值 |
metadata | object | 自定义元数据 |
created_at | string | 创建时间(ISO 8601) |
updated_at | string | 最后更新时间(ISO 8601) |
错误码
| HTTP | type | 触发条件 |
|---|
| 401 | authentication_error | 缺少或无效的认证令牌 |
| 404 | not_found_error | Skill 不存在或已删除:Skill '{skill_id}' was not found. |
完整错误信封说明详见 错误参考。