Documentación

Referencia de API

Consultar archivos gestionados

GET/v1/files/{file_id}

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.

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

Archivos gestionados consultados correctamente

application/json

Tipo
object
Campos obligatorios
idsource_kindsource_indexmodelstatusmime_typefile_namesize_bytescreated_atupdated_atexpires_at
  • idstringObligatorio

    Identificador público del objeto, usado en su ruta de detalles.

  • source_kindstringObligatorio

    Categoría de origen del archivo; determina ciclo de vida y protección por referencias.

  • source_indexintegerObligatorio

    Índice del resultado de origen.

  • modelstringObligatorio

    ID público de modelo del catálogo de la clave actual.

  • statusstringObligatorio

    Fases de almacenamiento en segundo plano como waiting/pending/archiving/ready/failed/deleting; la URL de descarga solo se obtiene tras ready.

  • mime_typestringObligatorio

    Tipo MIME verificado del archivo.

  • file_namestringObligatorio

    Nombre público del archivo descargado.

  • sha256stringOpcional

    SHA-256 del contenido archivado, si se conoce.

  • size_bytesintegerObligatorio

    Tamaño del archivo en bytes.

  • error_codestringOpcional

    Código público de error para decisiones de flujo.

  • created_atintegerObligatorio

    Fecha de creación en segundos Unix.

  • updated_atintegerObligatorio

    Última actualización en segundos Unix.

  • expires_atintegerObligatorio

    Segundos Unix; 0 indica retención a largo plazo. La API ordinaria sigue los días configurados; imágenes/vídeos persistentes protegen resultados por referencias. La eliminación conserva facturación e idempotencia.

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