Consultas
brand
Una marca activa por su slug, con sus productos en la misma consulta.
brand devuelve una marca activa a partir del slug de su URL. Su campo products trae los productos de la marca, con filtros y facetas, en la misma consulta.
brand(slug: String!): BrandDetail!Argumentos
| Argumento | Tipo | Regla |
|---|---|---|
slug | String! | Hasta 200 caracteres. Se recortan los espacios. |
BrandDetail
| Campo | Tipo | Descripción |
|---|---|---|
id | String! | ID de la marca. |
name | String! | Nombre. |
slug | String! | Slug. |
url | String! | Ruta pública de la marca. |
imageUrl | String | Logo de la marca, o su ícono si no tiene logo. |
description | String | Descripción. |
metaTitle | String | Título para buscadores. |
metaDescription | String | Descripción para buscadores. |
productCount | Int! | Productos publicados con la marca. |
products(input: StorefrontProductsInput) | SearchResult! | Productos de la marca. |
products acepta el mismo input que products y devuelve el mismo SearchResult. Filtra por el nombre de la marca: reemplaza lo que envíes en brands.
Ejemplo
query BrandPage($slug: String!, $page: Int = 1) {
brand(slug: $slug) {
id
name
url
imageUrl
description
products(input: { page: $page, pageSize: 24, includeFilters: false }) {
totalPages
products { id name url imageUrl price }
}
}
}curl --request POST "https://storefront.ecomiq.pe/graphql" \
--header "Content-Type: application/json" \
--header "x-Store-Domain: mi-tienda" \
--data-binary '{
"query": "query BrandPage($slug: String!, $page: Int = 1) { brand(slug: $slug) { id name url imageUrl description products(input: { page: $page, pageSize: 24, includeFilters: false }) { totalPages products { id name url imageUrl price } } } }",
"variables": { "slug": "andina", "page": 1 }
}'{
"data": {
"brand": {
"id": "7204558912004324355",
"name": "Andina",
"url": "/brands/andina",
"imageUrl": "https://…/andina.webp",
"description": "Prendas de algodón pima.",
"products": {
"totalPages": 1,
"products": [
{
"id": "7204558912004322039",
"name": "Polo de algodón pima",
"url": "/products/polo-de-algodon-pima",
"imageUrl": "https://…/polo.webp",
"price": 59.9
}
]
}
}
}
}Errores
| Código | Causa |
|---|---|
BAD_USER_INPUT | slug vacío o de más de 200 caracteres, o un input no válido. |
NOT_FOUND | La marca no existe en la tienda o está inactiva. |
STORE_CONTEXT_REQUIRED | x-Store-Domain falta o no corresponde a una tienda. |
Equivalente REST
GET / devuelve la misma marca, sin products. Para sus productos, filtra GET / con su nombre en brands.
Última actualización: