Lista todo o histórico de versões de uma Skill específica.
Cabeçalhos da requisição
|
Header |
Obrigatório |
Descrição |
|
Authorization |
Sim |
Bearer PAT — consulte Authorization: Bearer $QODER_PAT. |
Parâmetros de caminho
|
Parameter |
Tipo |
Obrigatório |
Descrição |
|
skill_id |
string |
Sim |
Identificador único da Skill. |
Exemplo de requisição
curl -X GET "https://api.qoder.com.cn/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions" \
-H "Authorization: Bearer $QODER_PAT"Exemplo de resposta
HTTP 200 OK
{
"data": [
{
"version": "1",
"skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
"status": "active",
"content_size": 309,
"content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
"created_at": "2026-05-18T15:35:24.248164Z",
"updated_at": "2026-05-18T15:36:01.767469Z"
}
]
}Campos da resposta
|
Field |
Tipo |
Descrição |
|
data |
array |
Array de objetos SkillVersion. |
Cada objeto SkillVersion contém:
|
Field |
Tipo |
Descrição |
|
version |
string |
Número da versão em formato string, como "1" ou "2". |
|
skill_id |
string |
ID da Skill associada. |
|
status |
string |
Status da versão. Atualmente sempre active. |
|
content_size |
integer |
Tamanho do conteúdo zip desta versão, em bytes. |
|
content_sha256 |
string |
Hash SHA-256 do conteúdo da versão. |
|
created_at |
string |
Timestamp de criação da versão (ISO 8601). |
|
updated_at |
string |
Timestamp da última atualização da versão (ISO 8601). |
Erros
|
HTTP |
Type |
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. |
Observações
Os números de versão são retornados como strings, por exemplo "1".
As versões seguem a ordem cronológica de criação.
Cada upload bem-sucedido via POST /v1/skills incrementa a versão.
Atualizações exclusivas de metadados via PUT não geram nova versão.
Para consultar o envelope completo de erros, veja Erros.