Productos relacionados

Ver los productos relacionados

GET /api/v1/ecommerce/shop/product-ratio/{id}

No pide token.

Parámetro	Dónde	Obligatorio	Reglas
id	Ruta	Sí	El id del producto o su slug, igual que en la ficha
page	Query	No	Página a devolver. Sin él, la 1

curl https://<dominio-de-la-empresa>/api/v1/ecommerce/shop/product-ratio/45 \
  -H "Accept: application/json"

Qué productos devuelve

• Los que tienen la misma categoría principal que el producto, es decir, la categoría elegida en su ficha del ERP. Las categorías asociadas desde la tienda no cuentan.
• Nunca el propio producto.
• Con las mismas condiciones que el listado: marcados para la tienda, que no sean servicios, dados de alta en el almacén de la tienda y, si la tienda muestra solo productos con stock, con stock mayor que 0.
• De 20 en 20. El tamaño de página no se puede cambiar.
• Sin un orden definido.

Si el producto no tiene categoría principal, la respuesta es correcta y la lista llega vacía.

Respuesta

La misma forma que el listado de productos: data con los productos, links y meta. Cada producto trae todos los campos del listado; el ejemplo muestra solo algunos.

{
  "data": [
    {
      "id": 46,
      "description": "Casaca impermeable",
      "slug": "p-002-casaca-impermeable",
      "price": 189,
      "in_offer": false,
      "offer_price": 0,
      "stock": 12,
      "has_variants": true
    }
  ],
  "links": {
    "first": "https://<dominio-de-la-empresa>/api/v1/ecommerce/shop/product-ratio/45?page=1",
    "last": "https://<dominio-de-la-empresa>/api/v1/ecommerce/shop/product-ratio/45?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://<dominio-de-la-empresa>/api/v1/ecommerce/shop/product-ratio/45",
    "per_page": 20,
    "to": 7,
    "total": 7
  },
  "success": true,
  "message": "Productos relacionados obtenidos de forma correcta."
}

Aquí links sí se puede seguir tal cual, porque la ruta es GET.

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
404	STORE_NOT_FOUND	La tienda no está publicada	La empresa debe publicarla desde el ERP
503	STORE_PAUSED	La tienda está pausada	Reintenta más tarde (Retry-After)
404	PRODUCT_NOT_FOUND	El producto no existe, no está marcado para la tienda virtual o es un servicio	Revisa el id o el slug
503	STORE_NOT_CONFIGURED	El ERP no tiene ningún almacén	Avisa a la empresa
429	RATE_LIMITED	Se superó el límite	Espera lo que indica Retry-After
500	INTERNAL_ERROR	Fallo del servidor	Reporta la reference