Saltar al contenido

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:

CollectionPage.graphql
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 }
    }
  }
}
Variables
{
  "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:

ProductPage.graphql
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:

ProductReviews.graphql
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:

SellerCatalog.graphql
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
    }
  }
}
Variables
{
  "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:

reviews.js
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:

collection-page.ts
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:

En esta página