Saltar al contenido
Consultas

collection

Una colección publicada por su slug, con sus primeros productos.

collection devuelve una colección publicada a partir del slug de su URL.

collection(slug: String!): CollectionItem!

Argumentos

ArgumentoTipoRegla
slugString!Hasta 200 caracteres. Se recortan los espacios.

Retorno

Un CollectionItem, el mismo tipo de collections. Su campo products(limit, sort) trae los primeros productos: 8 por defecto y hasta 24. Ver Productos de cada colección.

Para una página de colección con paginación y filtros, pasa el id de la respuesta a products(input: { collectionId }).

Ejemplo

Collection.graphql
query Collection($slug: String!) {
  collection(slug: $slug) {
    id
    slug
    name
    description
    imageUrl
    type
    productCount
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query Collection($slug: String!) { collection(slug: $slug) { id slug name description imageUrl type productCount } }",
    "variables": { "slug": "verano" }
  }'
Respuesta
{
  "data": {
    "collection": {
      "id": "7204558912004325401",
      "slug": "verano",
      "name": "Verano",
      "description": null,
      "imageUrl": null,
      "type": "Manual",
      "productCount": 2
    }
  }
}

Errores

CódigoCausa
BAD_USER_INPUTslug vacío o de más de 200 caracteres.
NOT_FOUNDLa colección no existe en la tienda o no está publicada.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

GET /v1/collections/{slug} devuelve la misma colección, sin products.

Última actualización:

En esta página