Saltar al contenido principal

Imágenes de productos

Las imágenes de producto permiten mostrar visualmente un producto dentro de la tienda. Cada producto puede tener múltiples imágenes ordenadas.


Propiedades

PropiedadDescripción
idIdentificador único de la imagen
srcURL de la imagen
positionOrden en el que se muestra dentro del producto
product_idID del producto al que pertenece

Endpoints

GET /images/{id}

Obtiene una imagen por su ID.

Ejemplo

GET /images/1

HTTP/1.1 200 OK

{
"id": 217,
"src": "https://cdn.v2.tiendanegocio.com/dev/gallery/2/img_2_7rhgep5hmnoo52yp.webp",
"position": 0,
"product_id": 1
}

GET /products/{product_id}/images

Obtiene las imágenes de un producto.

Ejemplo

GET /products/1/images

HTTP/1.1 200 OK

[
{
"id": 21,
"src": "https://cdn.v2.tiendanegocio.com/dev/pages/35/img_1774545272576.webp",
"position": 0,
"product_id": 35
},
{
"id": 24,
"src": "https://cdn.v2.tiendanegocio.com/dev/pages/35/img_1774547360296.webp",
"position": 1,
"product_id": 35
}
]

POST /products/{product_id}/images

Sube una nueva imagen a un producto.

Ejemplo de request

{
"position": 0,
"file": "data:image/webp;base64,${base64}"
}

Respuesta

HTTP/1.1 201 Created

{
"id": 235,
"src": "https://cdn.v2.tiendanegocio.com/dev/pages/464/img_1776090415088.webp",
"position": 0,
"product_id": 464
}

PUT /images/{id}

Actualiza una imagen existente.

Ejemplo

PUT /images/218

{
"position": 0,
"file": "data:image/webp;base64,${base64}"
}

Respuesta

HTTP/1.1 200 OK

{
"id": 218,
"src": "https://cdn.v2.tiendanegocio.com/dev/pages/36/img_1776086444774.webp",
"position": 0,
"product_id": 1
}

DELETE /images/{id}

Elimina una imagen.

Ejemplo

DELETE /images/218

HTTP/1.1 200 OK