Assets V2
Erros comuns
Formatos de erro retornados pelo assets-handler e pelo proxy de criação
Assets-handler (rotas /api/assets/*)
Erros tratados pelo AssetsController seguem o padrão:
{
"error": {
"message": "URL ou URLs devem ser fornecidas",
"code": "VALIDATION_ERROR",
"location": "assets.checkUrl",
"status": 400
}
}
Outros exemplos de location: assets.createAsset, assets.createAssetsFromInput. O campo code pode refletir códigos HTTP ou identificadores como DOWNLOAD_ERROR no download.
Validação (400)
Mensagens comuns incluem URL ausente, sanitização inválida ou URL inacessível quando needCheckUrl está ativo.
Proxy POST /api/assets/create (backend-service)
Erros do axios ao chamar o handler são convertidos em TolkyError com status propagado da resposta upstream. Timeouts de rede podem aparecer como 504 com mensagem de tempo limite.
Download (GET /assets/download/:id)
Respostas simples antigas usam { "error": "Asset not found" } ou objeto error aninhado com code em falhas de stream.