Ejemplos
Consultas completas para una página de colección, una ficha de producto, un catálogo de vendedor y reseñas paginadas.
Cada ejemplo arma una página completa con una o dos peticiones. Todos envían x-Store-Domain y pasan los valores dinámicos en variables.
Página de colección
La colección y su primera página de productos, con facetas, en una petición. El mismo $slug sirve para las dos selecciones:
query CollectionPage($slug: String!, $page: Int = 1) {
collection(slug: $slug) {
id
name
description
imageUrl
productCount
}
products(input: { collections: [$slug], page: $page, pageSize: 24 }) {
pageIndex
totalPages
totalCount
products {
id
name
slug
imageUrl
price
compareAtPrice
isAvailable
}
filters {
id
label
type
values { value label count selected }
}
}
}{
"slug": "summer",
"page": 1
}Para aplicar una faceta, agrega a input.filters valores como option:color:azul o attribute:material:algodón. Las reglas están en products.
Ficha de producto
El detalle, los relacionados y el resumen de reseñas salen en una petición:
query ProductPage($slug: String!) {
store { name currency }
product(slug: $slug) {
id
name
description
imageUrl
price
compareAtPrice
isAvailable
images { url name order }
variants {
id
sku
price
compareAtPrice
isAvailable
options { key name value }
}
seller { id name slug }
reviewSummary { averageRating reviewCount }
related(limit: 4) {
id
name
slug
imageUrl
price
isAvailable
}
}
}Las reseñas necesitan el id del producto. Pídelas en una segunda petición, después de mostrar el detalle:
query ProductReviews($productId: String!, $cursor: String) {
productReviews(
productId: $productId
limit: 10
cursor: $cursor
sortBy: "createdOn"
) {
data {
id
rating
title
content
reviewerName
isVerifiedPurchase
createdOn
}
hasNextPage
nextCursor
totalCount
}
}Catálogo de vendedor
La tienda, el perfil del vendedor y sus productos más nuevos en una petición:
query SellerCatalog($slug: String!, $pageSize: Int = 12) {
store {
id
name
currency
}
seller(slug: $slug) {
id
name
slug
logo
banner
tagline
rating { average totalReviews }
deliveryPolicy
}
products(input: { sellerSlugs: [$slug], pageSize: $pageSize, sort: NEWEST }) {
totalCount
products {
id
name
slug
imageUrl
price
isAvailable
}
}
}{
"slug": "acme",
"pageSize": 12
}Paginar reseñas
La primera petición envía cursor: null. Cada petición siguiente reenvía el nextCursor recibido, tal cual:
const document = `
query ReviewPage($productId: String!, $cursor: String) {
productReviews(
productId: $productId
limit: 20
cursor: $cursor
sortBy: "createdOn"
) {
data {
id
rating
title
content
reviewerName
createdOn
}
hasNextPage
nextCursor
}
}
`;
async function loadReviewPage(productId, cursor = null) {
const response = await fetch("https://storefront.ecomiq.pe/graphql", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-Store-Domain": "mi-tienda",
},
body: JSON.stringify({
query: document,
variables: { productId, cursor },
}),
});
const result = await response.json();
if (!response.ok || result.errors?.length) {
throw new Error(result.errors?.[0]?.message ?? `HTTP ${response.status}`);
}
return result.data.productReviews;
}
const firstPage = await loadReviewPage("456");
if (firstPage.hasNextPage) {
const secondPage = await loadReviewPage("456", firstPage.nextCursor);
console.log(secondPage.data);
}Si cambias rating, search o el orden, vuelve a empezar con cursor: null.
Con @ecomiq/core
El SDK valida data con Zod:
import { createClient } from "@ecomiq/core";
import { z } from "zod";
const CollectionPageData = z.object({
collection: z.object({
id: z.string(),
name: z.string(),
productCount: z.number(),
}),
products: z.object({
totalCount: z.number(),
products: z.array(
z.object({
id: z.string(),
name: z.string(),
slug: z.string(),
price: z.number(),
}),
),
}),
});
const api = createClient({ domain: "mi-tienda" });
const data = await api.graphql(
`
query CollectionPage($slug: String!) {
collection(slug: $slug) { id name productCount }
products(input: { collections: [$slug], pageSize: 24 }) {
totalCount
products { id name slug price }
}
}
`,
CollectionPageData,
{ slug: "summer" },
);Siguientes pasos
Última actualización: