Documentación

Referencia de API

Obtener URL temporal de descarga

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

Archivos históricos de la misma cuenta y clave; permite claves válidas con cuota agotada, pero rechaza revocadas/caducadas. Descarga exige ready; eliminación con referencias devuelve 409. retry solo guarda el original, sin regenerar. API ordinaria por días; tareas persistentes protegen referencias; expires_at=0 indica sin caducidad fija.

Reproducción y descarga

Consulta el estado del archivo antes de pedir una URL temporal; obtenerla no hace que esté disponible antes de que el almacenamiento sea ready. Envía la clave original solo a GloopAPI; no la adjuntes al descargar de la dirección HTTPS devuelta.

Los vídeos persistentes usan URL temporales del almacenamiento de objetos con reproducción Range nativa. El GET completo de la ruta content de vídeos ordinarios usa un transporte distinto. Si caduca el enlace, solicita otro; renovar un enlace no recupera un archivo caducado o eliminado.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Parámetros de ruta

  • file_idstringObligatorio

    ID público de archivo gestionado de la misma clave.

Respuestas y errores

HTTP 200

URL temporal de descarga obtenida correctamente

application/json

Tipo
object
Campos obligatorios
urlexpires_at
  • urlstringObligatorio

    URL firmada temporal; no la reveles ni conserves a largo plazo.

    Formato
    "uri"
  • expires_atintegerObligatorio

    Segundos Unix.

HTTP 400

Campos o parámetros de solicitud inválidos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto/capacidad no disponible o función desactivada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto de idempotencia/cotización, objeto no preparado o aún referenciado.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 503

Servicio, precios o almacenamiento no disponibles.

application/json

Tipo
object
Campos obligatorios
error