Documentación

Referencia de API

Consultar imagen de referencia

GET/v1/image-assets/{asset_id}

Misma cuenta y clave; recurso caducado devuelve 410; eliminación referenciada por tarea sin terminar devuelve 409.

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

  • asset_idstringObligatorio

    ID de recurso de imagen ia_ subido con la misma clave.

Respuestas y errores

HTTP 200

Imagen de referencia consultada correctamente

application/json

Tipo
object
Campos obligatorios
idmime_typesize_byteswidthheightexpires_at
  • file_idstringOpcional

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

  • idstringObligatorio

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

  • mime_typestringObligatorio

    Tipo MIME verificado del archivo.

  • size_bytesintegerObligatorio

    Tamaño del archivo en bytes.

  • widthintegerObligatorio

    Anchura de imagen en píxeles.

  • heightintegerObligatorio

    Altura de imagen en píxeles.

  • expires_atintegerObligatorio

    Segundos Unix; 0 indica que no hay caducidad fija. La subida se asocia a un archivo gestionado; la lectura exige la misma cuenta y clave.

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 410

La imagen de referencia caducó o se eliminó (asset_expired).

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