查询 Skill 列表

支持查询指定组织下的 Skill 列表。

可以通过该接口，查询指定组织下的 Skill 列表。

请求方式

GET

调用地址

https://api.${endpoint}/v1/org/skill/list

调用验证

使用账号级 DevKey / DevSecret 的 Basic 鉴权。

请求

请求示例

curl -X GET 'https://api.${endpoint}/v1/org/skill/list?org_id=p-xxxx&keyword=refund&owner_type=ORGANIZATION&enable=true' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/org/skill/list?org_id=p-xxxx&keyword=refund&owner_type=ORGANIZATION&enable=true' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

此代码块在浮窗中显示

请求头

字段	类型	说明
Authorization	Basic ${BASIC_TOKEN}	使用 `DevKey:DevSecret` Base64 后的 Basic Token。
Locale	String	可选。响应文案语言，默认 `en_US`。

请求参数（Query Parameters）

参数	类型	说明	required
org_id	String	组织 ID。	true
keyword	String	关键词。	false
category_id	String	Skill 分类 ID。	false
owner_type	String	Skill 归属类型，如 `ORGANIZATION`。	false
owner_agent_id	String	私有 Skill 归属 Agent ID。	false
enable	Boolean	是否只返回启用或停用的 Skill。	false

响应

响应示例

{ "code": 0, "message": "OK", "data": [ { "id": "skill-xxxx", "name": "refund-policy", "display_name": "退款政策", "owner_type": "ORGANIZATION", "enable": true } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "id": "skill-xxxx",
      "name": "refund-policy",
      "display_name": "退款政策",
      "owner_type": "ORGANIZATION",
      "enable": true
    }
  ]
}

此代码块在浮窗中显示

成功响应

响应项复用控制台 Skill 列表字段，包含 Skill ID、名称、描述、归属方、分类、版本、启用状态等信息。

失败响应

字段	类型	说明
code	Integer	错误码。
message	String	错误详情。

状态码

状态码	说明
200	成功
400	参数错误
401	未授权
403	权限不足
429	请求过于频繁
500	服务器错误