Skip to main content
POST /media/resolve analisa uma URL pública e retorna metadados normalizados para seu app. Requer escopo media:resolve.

Quando usar

  • Exibir título, thumbnail e duração antes do download
  • Listar formatos disponíveis para o usuário escolher
  • Obter data.id para usar como media_id no download

Exemplos

Resposta

O campo data.id é o identificador público (med_...). Envie como media_id em POST /media/download.

Erros comuns

TTL do resolve

O data.id expira após 1 hora por padrão (API_MEDIA_RESOLVE_TTL_SECONDS=3600). Se receber media_not_found no download, execute resolve novamente. Próximo passo: Download assíncrono