Saltar al contenido principal

Gestión de imágenes a través de la API de Multivende

Actualización

Puedes administrar tus imágenes tanto de los productos padres como las versiones.

Las imágenes se organizan en álbumes. Para obtener la lista de estos álbumes, es necesario utilizar el endpoint "Get products picture set". El álbum predeterminado es productPictureSetId = null, que ya ha sido creado por Multivende para facilitar la carga de imágenes.

Puedes realizar carga de las imágenes, tanto para los productos padres como para las versiones:

Productos Padres:

En la siguiente carpeta podrás encontrar los endpoint asociados a la carga de imágenes de productos padre.

Versiones:

En la siguiente carpeta podrás encontrar los endpoint asociados a la carga de imágenes de versiones de productos.

 

Consultar imágenes de un producto

  • Get products pictures: Te permite obtener las imágenes asociadas al producto, al hacer click en la URL del response podrás visualizar la imagen del producto.
[
 {
  "url": "https://s3-us-west-2.amazonaws.com/im-prod-products-images/1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.jpg",
  "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "provider": "s3",
  "title": null,
  "alt": null,
  "description": null,
  "storageUrl": "https://s3-us-west-2.amazonaws.com/im-prod-products-images",
  "storagePath": null,
  "fileKey": "1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.jpg",
  "originalServerPath": "/tmp/AivQ8EPan8P-L1Fp2hV68sqn.jpg",
  "originalFileName": "1.jpg",
  "fileName": null,
  "fileType": "image/jpeg",
  "fileSize": 14257,
  "position": 1,
  "status": "created",
  "createdAt": "2021-06-02T20:26:14.000Z",
  "updatedAt": "2021-06-02T20:26:14.000Z",
  "CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "ProductPictureSetId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "ProductId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "ProductPictureSet": {
   "branch": "Album-test-App",
   "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "name": "Album-test-App",
   "code": null,
   "description": null,
   "status": "created",
   "createdAt": "2021-04-22T23:51:29.000Z",
   "updatedAt": "2021-04-22T23:51:29.000Z",
   "CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
 }
]

Es importante que descargues la imagen y la almacenes dentro del respectivo repositorio de tu integración, si esta URL la expones en un sistema externo Multivende bloqueará la solicitud.

 

Eliminar imágenes a un producto:

  • Delete product image by id: Te permite eliminar una imagen enviando dentro del request el "product_image_id"
    • Para conocer las imágenes asociadas al producto, puedes obtenerlas consultando el Producto (Get Product by Id) dejando el filtro _include_product_picture=true.

Cargar imágenes a un producto: la carga de imágenes puedes realizarse mediante los archivos almacenados de manera local o a través de una url pública. A continuación te dejamos el detalle de los endpoints:

Importante:

  • ProductPictureSetId: Corresponde al "_id" del album en donde será cargada está imagen, recordar que si el album por defecto debe ir "null".
  • position: De carácter opcional, es la posición de la imagen, en caso de ser "0" está será listada primero que el resto.

 

  • Upload picture to product by url:Te permite cargar una imagen desde una URL enviando dentro del Body el "ProductId" y las diferentes URL's de las imágenes que quieras anexar al producto.

 

La URL no debe contener bloqueos ni tokens que impidan el acceso y debe permitir la descarga. Multivende descargará la imagen y la almacenará en su repositorio.

 

Actualizar la posición de una imagen dentro de un albúm

  • Update product picture position:Te permite actualizar las posiciones de las imágenes dentro del album enviando dentro del request el "MerchantId" y "ProductPictureSetId"

Dentro del "Body" enviarás el "ProductId" y un array donde cada una de las entradas será la posición en donde quieras organizar la respectiva imagen.

 

La información de este artículo también aplica para las versiones de los productos, la única diferencia es que para los endpoints de las versiones trabajarás con los "_id" respectivos a las versiones.

 

Si tienes dudas sobre este tema contáctanos a través de api@multivende.com y estaremos felices de ayudarte.

Equipo Integraciones API Multivende

 

 

Artículos relacionados