SearchSkills - : Central de Documentação do Alibaba Cloud

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

GET /openapi/skills HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
keyword	string	Não	A palavra-chave de pesquisa.	ecs.
categoryCode	string	Não	O código da categoria de habilidade. Separe vários códigos com vírgulas. Para uma categoria de segundo nível, use o formato: categoria de primeiro nível.categoria de segundo nível.	compute.serverless,network.
nextToken	string	Não	O token para a próxima consulta. Defina este valor como o NextToken retornado pela chamada de API anterior.	AAAAAZjtYxxxxxxxx.
maxResults	integer	Não	O número máximo de entradas por página para uma consulta paginada. Valor máximo: 100. Valor padrão: 20.	20
skip	integer	Não	O número de entradas a ignorar para paginação.	10
searchMode	string	Não	Especifica o modo de pesquisa. Defina como semantic para ativar a pesquisa vetorial.	semantic.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
requestId	string	O ID da solicitação.	53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3
nextToken	string	O valor NextToken usado para recuperar mais resultados.	AAAAAZjtYxxxxxxxx.
maxResults	integer	O número máximo de entradas por página para uma consulta paginada. Valor máximo: 100. Valor padrão: 20.	20
totalCount	integer	O número total de registros.	22
data	array	A lista de habilidades retornadas.
	Skill	Os detalhes da habilidade retornada.

Exemplos

Resposta de sucesso

JSON formato

{
  "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": ""
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	InvalidParam.NextToken	The specified NextToken is not valid.
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.
500	InternalServerError	The request has failed due to a temporary failure of the server.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.