Documentación

Referencia de API

Reintentar archivado de archivo

POST/v1/files/{file_id}/retry

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.

Recuperar un fallo de guardado

Comprueba primero el espacio disponible y la causa. Esta operación vuelve a solicitar capacidad y archiva el resultado original; no llama de nuevo al servicio de generación ni cambia los cargos de la tarea. Si la fuente original caducó, el reintento puede seguir fallando.

Gestiona los archivos protegidos por referencias de tareas persistentes mediante el ciclo de vida de la tarea; no elimines archivos referenciados para liberar espacio. Comprueba facturación y almacenamiento por separado; consulta Facturación.

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

Archivado de archivo reintentado 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