Skip to main content
1

Reserve o envio

Envie POST /v1/assets/files com título e nome do arquivo, ou POST /v1/assets/videos com título. A resposta já contém o asset e sua variante, além de upload.url, upload.method e upload.expires_at.
2

Envie os bytes

Faça o upload diretamente para upload.url, usando o método informado. Essa URL é uma credencial temporária: não a publique nem registre em logs. expires_at pode ser null quando não houver um prazo informado.
3

Confirme

Chame POST /v1/assets/{id}/confirm com {}. A Hubfy verifica o envio. Arquivos prontos podem ser baixados; vídeos podem continuar em processamento.
4

Acompanhe

Consulte GET /v1/assets/{id} ou receba asset.updated. Os estados são uploading, processing, ready e failed. Um item excluído deixa de aparecer nas consultas normais.

​
Download de arquivo privado

Use GET /v1/assets/{id}/download para um arquivo pronto. A resposta contém uma URL assinada com validade de uma hora. Solicite outra URL quando precisar renovar o acesso.

​
Excluir conteúdo

DELETE /v1/assets/{id} registra a remoção e sua limpeza externa. A Hubfy repete a limpeza quando houver uma falha temporária.