Documentación

Referencia de API

Importar imagen de referencia HTTPS

POST/v1/image-assets/import

Con subidas desactivadas, la ruta devuelve 404 directamente. Un solo objeto JSON, sin campos desconocidos, cuerpo máximo de 8192 bytes. Una importación fallida o sin preparar no debe tratarse como reintento de generació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

Encabezados de solicitud

  • Idempotency-KeystringObligatorio

    Conserva la intención original con la misma clave; tras una interrupción, consulta recuperación primero. No reenvíes a ciegas estados desconocidos.

    Longitud mínima
    1
    Longitud máxima
    191

Cuerpo de solicitud · application/json

Tipo
object
Campos obligatorios
url
Propiedades adicionales
false

Cuerpo de solicitud obligatorio

  • urlstringObligatorio

    URL HTTPS pública de imagen, sujeta a validación SSRF y del contenido de imagen.

    Formato
    "uri"

Respuestas y errores

HTTP 200

Imagen de referencia HTTPS importada 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 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