Documentación

Referencia de API

Consultar archivos gestionados

GET/v1/files

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 consulta

  • afterintegerOpcional

    Usa next_cursor de la respuesta original; el servicio fija 50 elementos por página.

    Valor predeterminado
    0
    Mínimo
    0

Respuestas y errores

HTTP 200

Archivos gestionados consultados correctamente

application/json

Tipo
object
Campos obligatorios
datanext_cursor
  • dataarrayObligatorio
    Campos secundarios de data (1)
    • []objectOpcional
      Campos secundarios de [] (13)
      • 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.

  • next_cursorintegerObligatorio

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