Recupera os detalhes de uma única Skill por ID.
Cabeçalhos da requisição
|
Cabeçalho |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Bearer PAT — consulte Authorization: Bearer $QODER_PAT. |
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
skill_id |
string |
Sim |
Identificador exclusivo da Skill, com o prefixo skill_. |
Exemplo de requisição
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d" \
-H "Authorization: Bearer $QODER_PAT"Exemplo de resposta
HTTP 200 OK
{
"id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"type": "skill",
"name": "my-custom-skill",
"description": "Custom Skill example",
"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"
}Campos da resposta
|
Campo |
Tipo |
Descrição |
|
id |
string |
Identificador exclusivo da Skill, com o prefixo skill_. |
|
type |
string |
Tipo de recurso. Sempre "skill". |
|
name |
string |
Nome da Skill. |
|
description |
string |
Descrição da Skill. |
|
skill_type |
string |
Tipo da Skill: custom ou prebuilt. |
|
status |
string |
Status da Skill. Atualmente sempre active. |
|
version |
integer |
Número da versão atual, iniciando em 1. |
|
content_size |
integer |
Tamanho do conteúdo zip em bytes. |
|
content_sha256 |
string |
Hash SHA-256 do conteúdo zip. |
|
metadata |
object |
Metadados definidos pelo usuário. |
|
created_at |
string |
Timestamp de criação (ISO 8601). |
|
updated_at |
string |
Timestamp da última atualização (ISO 8601). |
Erros
|
HTTP |
Tipo |
Gatilho |
|
401 |
authentication_error |
Token de autenticação ausente ou inválido. |
|
404 |
not_found_error |
A Skill não existe ou foi excluída. |
Para ver o envelope completo de erros, consulte Erros.