Documentação

Referência da API

Obter URL temporária de download

GET/v1/files/{file_id}/download-url

Arquivos históricos da mesma conta e chave; permite chaves válidas com cota esgotada, mas rejeita revogadas/expiradas. Download exige ready; exclusão com referências retorna 409. retry só salva o original, sem regenerar. API comum por dias; tarefas persistentes protegem referências; expires_at=0 indica ausência de expiração fixa.

Reprodução e download

Consulte o status do arquivo antes de pedir uma URL temporária; obtê-la não disponibiliza o arquivo antes de o armazenamento estar ready. Envie a chave original apenas ao GloopAPI; não a anexe ao baixar do endereço HTTPS retornado.

Vídeos persistentes usam URLs temporárias do armazenamento de objetos com reprodução Range nativa. O GET completo da rota content de vídeos comuns usa transporte diferente. Se o link expirar, solicite outro; renovar links não recupera arquivos expirados ou excluídos.

Autenticação e permissões

Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticação: BearerAuth

Solicitação

Parâmetros de caminho

  • file_idstringObrigatório

    ID público de arquivo gerenciado da mesma chave.

Respostas e erros

HTTP 200

URL temporária de download obtida com sucesso

application/json

Tipo
object
Campos obrigatórios
urlexpires_at
  • urlstringObrigatório

    URL assinada temporária; não divulgue nem guarde por longo prazo.

    Formato
    "uri"
  • expires_atintegerObrigatório

    Segundos Unix.

HTTP 400

Campos ou parâmetros de solicitação inválidos.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 404

Objeto/recurso indisponível ou função desativada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 409

Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 429

Limite de solicitações/fila.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 503

Serviço, preços ou armazenamento indisponíveis.

application/json

Tipo
object
Campos obrigatórios
error
Pronto para criar? Abra console para criar uma chave de API, ou explore recursos.