SearchSkills - 搜索阿里云 Agent Skills - 云 Skills 门户

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /openapi/skills HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
keyword	string	否	搜索关键词	ecs
categoryCode	string	否	Skill 类目 Code，如果传入多个，使用英文逗号隔开。如果是二级类目，使用一级类目.二级类目的方式传入	compute.serverless,network
nextToken	string	否	下一个查询开始 Token，取值为上一次 API 调用返回的 NextToken 参数值	AAAAAZjtYxxxxxxxx
maxResults	integer	否	分页查询时每页的最大条目数。最大值为 100。默认值为 20。	20
skip	integer	否	分页参数，跳过数目	10
searchMode	string	否	开启向量搜索的方式需指定 semantic	semantic

返回参数

名称	类型	描述	示例值
	object	Schema of Response
requestId	string	Id of the request	53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3
nextToken	string	返回的 NextToken，用来返回更多结果。	AAAAAZjtYxxxxxxxx
maxResults	integer	分页查询时每页的最大条目数。最大值为 100。默认值为 20。	20
totalCount	integer	数据总记录数。	22
data	array	返回的 Skill 列表
	Skill	返回的 Skill 详情

示例

正常返回示例

JSON格式

{
  "requestId": "53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3",
  "nextToken": "AAAAAZjtYxxxxxxxx",
  "maxResults": 20,
  "totalCount": 22,
  "data": [
    {
      "skillName": "deploy-to-vercel",
      "displayName": "ECS 实例管理",
      "description": "ECS 实例管理",
      "categoryCode": "compute",
      "categoryName": "计算",
      "subCategoryCode": "ecs",
      "subCategoryName": "弹性计算",
      "likeCount": 128,
      "installCount": 1024,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-03-17T00:00:00Z",
      "descriptionEn": "",
      "nameEn": "",
      "categoryNameEn": "",
      "subCategoryNameEn": "",
      "githubPath": ""
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParam.NextToken	The specified NextToken is not valid.	指定的nextToken无效。
400	NextTokenParameterMismatch	The request uses the same nextToken as the previous request, but with different parameters. NextTokens should not be reused across non-identical requests. Each unique request must have a distinct nextToken.	请求使用了与之前请求相同的nextToken，但参数不同。请勿在参数不同的请求中重复使用同一nextToken，每个独立请求必须使用唯一的nextToken。
500	InternalServerError	The request has failed due to a temporary failure of the server.	由于服务器暂时故障，请求失败。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。