Acesso Comercial / Docs / Storefront
Ctrl K

Storefront API

Crie sua própria loja virtual usando nossa API GraphQL. Autenticação segura, carrinho, checkout e muito mais.

O que é a Storefront API?

A Storefront API permite que desenvolvedores criem frontends completamente personalizados para lojas na plataforma Acesso Comercial. Você tem acesso a todas as operações voltadas ao cliente (produtos, carrinho, checkout, autenticação) enquanto as operações administrativas ficam isoladas e protegidas.

Same-Domain Architecture: Seu frontend roda no domínio da loja (suaLoja.acessocomercial.com ou domínio customizado). Cookies httpOnly funcionam automaticamente — sem CORS, sem tokens, sem complicação.

Arquitetura

O sistema usa um API Gateway (Nginx) que roteia requisições para o Storefront Server:

Fluxo
Browser (sua loja)
  │
  ├─ /graphql   →  Storefront GraphQL (schema filtrado)
  ├─ /api/storefront/explorer  →  GraphQL Explorer (GraphiQL)
  └─ /checkout                    →  SPA Checkout (React)

O Storefront Server expõe apenas operações voltadas ao cliente final.
Schema filtrado = só queries/mutations de storefront.

Como integrar

Quick Start

O jeito mais rápido de começar — faça um fetch para listar produtos:

JavaScript
const response = await fetch('/graphql', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    query: `{
      client(hostname: "minhaloja") {
        products(first: 10) {
          edges {
            node {
              id
              title
              price
              images {
                url
              }
            }
          }
        }
      }
    }`
  }),
  credentials: 'include'
});

const { data } = await response.json();