Pular para o conteúdo
MeWeb

Desenvolvedores

Primeiros passos

Você não precisa de chave de API nem de cadastro de app: a Storefront API é pública e resolvida pelo host da loja.

1. Primeira chamada

Troque SUA-LOJA pelo subdomínio da loja e chame os dados públicos:

terminal
curl https://SUA-LOJA.meweb.com.br/api/v1/storefront/store
# → { "data": { "name": "Minha Loja", "email": "...", "phone": "...", ... } }

Toda resposta de sucesso vem no envelope { "data": ... } (listas paginadas incluem pageInfo); detalhes em Erros e limites.

2. Catálogo

terminal
# Coleções em destaque com produtos
curl https://SUA-LOJA.meweb.com.br/api/v1/storefront/home

# Detalhe de um produto (PDP)
curl https://SUA-LOJA.meweb.com.br/api/v1/storefront/products/camiseta-basica

# Busca paginada
curl "https://SUA-LOJA.meweb.com.br/api/v1/storefront/search?q=camiseta&limit=12"

3. Rode o tema starter

O caminho mais rápido para uma vitrine completa (home, coleção, produto, carrinho e checkout) é partir do tema starter, um app Next.js open-source e sem dependências da plataforma. Configure o host da loja:

.env.local
# .env.local do starter
MEWEB_STORE_HOST=sua-loja.meweb.com.br
# Opcional: origem da API (padrão https://<MEWEB_STORE_HOST>)
# MEWEB_API_ORIGIN=https://sua-loja.meweb.com.br
terminal
npm install
npm run dev
# → http://localhost:3005 com a vitrine da SUA loja

4. Próximos passos