Assets V2
Health check de links
Como o MediaHealthChecker valida URLs sem baixar o arquivo inteiro
O serviço usa MediaHealthChecker com cache (TTL ~5 minutos no código), concorrência limitada e timeout por requisição (ordem de dezenas de segundos).
Onde entra no fluxo
- Sob demanda no create:
needCheckUrl: trueemPOST {{BASE_URL}}/assets/create— se o link falhar, a criação retorna erro de validação. - Endpoint dedicado:
POST {{BASE_URL}}/assets/check-url— uma ou várias URLs, sem gravar asset.
Objeto de resultado
Campos comuns no resultado de uma URL:
url: URL verificadaok: se a URL foi considerada acessívelstatus: código HTTP quando aplicávelmimeType: MIME detectadotype: categoria (img,video,audio,document, etc.)
Boas práticas
- Evite disparar lotes muito grandes em paralelo; há limite de concorrência e custo de rede.
- Cache reduz chamadas repetidas dentro do TTL.
- Para apenas saber se já existe registro na base, use
needCheckExistingno create (ver URL e duplicidade).