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.