Saltar al contenido
Consultas

relatedProducts

Productos relacionados con otro, a partir de su ID.

relatedProducts devuelve productos parecidos al indicado. Primero busca por similitud y completa con productos de la misma categoría, de la misma marca y del resto del catálogo, solo con productos disponibles.

relatedProducts(productId: String!, limit: Int): [ProductSummary!]!

Si ya pides el producto con product, usa su campo related(limit) y ahórrate la segunda petición.

Argumentos

ArgumentoTipoPredeterminadoRegla
productIdString!—El id de product o products.
limitInt8De 1 a 12. Un valor fuera de rango se ajusta al extremo más cercano.

Si el producto no existe o no está publicado, la lista llega vacía.

Retorno

Una lista de ProductSummary, el mismo tipo de products. Incluye reviews, con los argumentos descritos en Reseñas de cada producto.

Ejemplo

RelatedProducts.graphql
query RelatedProducts($productId: String!, $limit: Int) {
  relatedProducts(productId: $productId, limit: $limit) {
    id
    name
    slug
    imageUrl
    price
    compareAtPrice
    isAvailable
    brand
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query RelatedProducts($productId: String!, $limit: Int) { relatedProducts(productId: $productId, limit: $limit) { id name slug imageUrl price compareAtPrice isAvailable brand } }",
    "variables": { "productId": "456", "limit": 4 }
  }'
Respuesta
{
  "data": {
    "relatedProducts": [
      {
        "id": "789",
        "name": "Taza grande",
        "slug": "taza-grande",
        "imageUrl": "/taza-grande.jpg",
        "price": 12,
        "compareAtPrice": null,
        "isAvailable": true,
        "brand": "Acme"
      }
    ]
  }
}

Errores

CódigoCausa
BAD_USER_INPUTproductId no es un ID válido.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

GET /v1/products/{productId}/related devuelve la misma lista.

Última actualización:

En esta página