GraphQL
Lee tienda, productos, colecciones, vendedores, reseñas, pagos y artículos en una sola petición a POST /graphql.
Con GraphQL pides la tienda, un producto y sus relacionados en una sola petición, y recibes solo los campos que seleccionas. El schema tiene solo lecturas: carritos, checkout, clientes y cualquier escritura van por REST.
Inicio rápido
Envía la consulta por POST con el slug o dominio de la tienda en x-Store-Domain:
curl --request POST "https://storefront.ecomiq.pe/graphql" \
--header "Content-Type: application/json" \
--header "x-Store-Domain: mi-tienda" \
--data-binary '{
"query": "query Store { store { id name currency language } }"
}'{
"data": {
"store": {
"id": "7204558912004325301",
"name": "Mi tienda",
"currency": "PEN",
"language": "es"
}
}
}El endpoint acepta una operación por petición, siempre por POST. Los IDs son strings opacos: guárdalos y reenvíalos tal cual.
Consultas
store
Nombre, logo, tipo, moneda e idioma de la tienda.
products
Búsqueda paginada con filtros, facetas y orden.
product
Detalle de un producto por slug.
relatedProducts
Productos relacionados a partir de un ID.
collections
Colecciones con búsqueda, orden y sus primeros productos.
collection
Una colección por slug.
sellers
Vendedores del marketplace y su calificación.
seller
Perfil, enlaces y políticas de un vendedor.
productReviews
Reseñas de un producto con cursor, búsqueda y orden.
storeReviews
Reseñas recientes de toda la tienda para testimonios.
paymentMethods
Métodos de pago que ofrece el checkout.
articles
Artículos publicados con búsqueda, carpeta y etiqueta.
GraphQL o REST
| Para | Usa |
|---|---|
| Combinar tienda, vendedor y productos en una respuesta | GraphQL |
| Pedir solo algunos campos de un recurso | GraphQL |
| Buscar productos con filtros y facetas | GraphQL o REST |
| Crear o actualizar carrito, checkout o cliente | REST |
| Consultar geografía, tracking o analítica | REST |
| Trabajar con OpenAPI o una colección de Postman | REST |
Siguientes pasos
Última actualización: