Consultas
route
Qué hay publicado en una ruta de la tienda: producto, categoría, marca, colección o redirección.
route dice qué hay publicado en una ruta de la tienda y lo devuelve completo. Úsala en la ruta comodín de tu frontend.
route(path: String!, previewKey: String): UrlResolutionArgumentos
| Argumento | Tipo | Regla |
|---|---|---|
path | String! | La ruta, sin dominio ni query. Vacía responde BAD_USER_INPUT. |
previewKey | String | La clave del enlace de vista previa del admin. Con una clave válida, también llega un producto sin publicar. |
Si nada coincide, route llega como null.
UrlResolution
| Campo | Tipo | Descripción |
|---|---|---|
kind | String! | product, category, brand, collection o redirect. |
url | String! | La URL vigente del recurso. |
handle | String | El slug del recurso. null con redirect. |
product | ProductDetail | La ficha, con kind: "product". Ver product. |
category | CategoryDetail | La categoría, con kind: "category". |
brand | BrandDetail | La marca, con kind: "brand". Ver brand. |
collection | CollectionItem | La colección, con kind: "collection". Ver collections. |
- Con
redirect, redirige con301aurl. Pasa con URLs viejas, en mayúsculas o con/al final. - Un producto sin publicar que llega con
previewKeytraeisPreview: true: no lo guardes en caché ni lo indexes.
CategoryDetail
| Campo | Tipo | Descripción |
|---|---|---|
id | String! | ID de la categoría. |
name | String! | Nombre. |
slug | String! | Slug. |
url | String! | Ruta pública de la categoría. |
description | String | Descripción. |
imageUrl | String | Imagen. |
metaTitle | String | Título para buscadores. |
metaDescription | String | Descripción para buscadores. |
parentId | String | ID de la categoría padre. |
productCount | Int! | Cantidad de productos. |
ancestors | [CategoryLink!]! | De la raíz al padre, para las migas. |
children | [CategoryItem!]! | Subcategorías. |
products(input: StorefrontProductsInput) | SearchResult! | Productos de la categoría y de sus subcategorías. |
products acepta el mismo input que products e ignora categories.
| Tipo | Campos |
|---|---|
CategoryLink | id: String!, name: String!, url: String! |
CategoryItem | id: String!, name: String!, slug: String!, url: String!, imageUrl: String, parentId: String, path: String!, order: Int!, productCount: Int! |
Ejemplo
query Route($path: String!) {
route(path: $path) {
kind
url
product { id name price }
category {
id
name
ancestors { name url }
products(input: { pageSize: 24, includeFilters: false }) {
totalPages
products { id name url imageUrl price }
}
}
brand { id name }
collection { id name }
}
}curl --request POST "https://storefront.ecomiq.pe/graphql" \
--header "Content-Type: application/json" \
--header "x-Store-Domain: mi-tienda" \
--data-binary '{
"query": "query Route($path: String!) { route(path: $path) { kind url product { id name price } category { id name ancestors { name url } products(input: { pageSize: 24, includeFilters: false }) { totalPages products { id name url imageUrl price } } } brand { id name } collection { id name } } }",
"variables": { "path": "/categories/polos" }
}'{
"data": {
"route": {
"kind": "category",
"url": "/categories/polos",
"product": null,
"category": {
"id": "7204558912004327982",
"name": "Polos",
"ancestors": [{ "name": "Hombre", "url": "/categories/hombre" }],
"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
}
]
}
},
"brand": null,
"collection": null
}
}
}Errores
| Código | Causa |
|---|---|
BAD_USER_INPUT | path vacío. |
STORE_CONTEXT_REQUIRED | x-Store-Domain falta o no corresponde a una tienda. |
Equivalente REST
GET / devuelve lo mismo, sin los campos que solo tiene GraphQL, como products o related. Si nada coincide, responde 404 Url.NotFound.
Última actualización: