Saltar al contenido

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:

Terminal
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 } }"
  }'
Respuesta
{
  "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

GraphQL o REST

ParaUsa
Combinar tienda, vendedor y productos en una respuestaGraphQL
Pedir solo algunos campos de un recursoGraphQL
Buscar productos con filtros y facetasGraphQL o REST
Crear o actualizar carrito, checkout o clienteREST
Consultar geografía, tracking o analíticaREST
Trabajar con OpenAPI o una colección de PostmanREST

Siguientes pasos

Última actualización:

En esta página