Storefront Data API

A Storefront Data API é a camada estável entre a plataforma Corvex e os seus Themes.

Rotas públicas /public/stores/:storeId/...
        ↓
@corvex/theme-sdk (storefront.*)
        ↓
Theme Runtime (template → section → block → snippet)

Regra de ouro

Use apenas o Theme SDK e as rotas públicas documentadas aqui.

O desenvolvedor de Theme não precisa de:

Acesso ao backend interno da Corvex
Rotas administrativas
Credenciais de backoffice
Conhecimento de banco de dados ou infraestrutura

usePage devolve o contexto inteiro da página. O argumento ('product', 'collection') é ignorado. Ele usa:

import {
  createStorefront,
  usePage,
  defineSection,
  defineSectionData,
} from '@corvex/theme-sdk';

Três categorias de dados

Categoria	Quando usar	Exemplo
Contexto de página	A plataforma já sabe qual recurso renderizar	`page.product` em `/products/camiseta`
Consulta (query)	A section precisa buscar dados extras	`storefront.products.list()` na home
Referência do lojista	Valor escolhido no editor (picker)	Field `product_list` → UUIDs em settings

High-level vs low-level

API simples (90% dos casos)

const products = await storefront.products.list({
  first: 8,
  sortBy: 'BEST_SELLING',
});

API avançada (futuro)

const { products } = await storefront.query(PRODUCTS_QUERY, {
  variables: { first: 8 },
});

storefront.query() (GraphQL) está reservado para versões futuras. Use a API high-level hoje.

Rotas públicas mapeadas

SDK	HTTP (vitrine pública)
`storefront.products.list()`	`GET /public/stores/:storeId/products`
`storefront.products.get()`	`GET /public/stores/:storeId/products/:idOrSlug`
`storefront.categories.list()`	`GET /public/stores/:storeId/categories`
`storefront.collections.*`	alias de `categories`
`storefront.search.query()`	`GET /public/stores/:storeId/products?search=...`
`storefront.reviews.list()`	`GET /public/store-reviews?storeId=...`
`storefront.reviews.summary()`	`GET /public/store-reviews/summary?storeId=...`
`storefront.reviews.create()`	`POST /public/store-reviews`
`storefront.leads.capture()`	`POST /public/store-leads`
`storefront.recommendations.list()`	`GET /public/stores/:storeId/products/:id/recommendations`
`storefront.discountRanges.list()`	`GET /public/stores/:storeId/discount-ranges`
`storefront.paymentDiscounts.list()`	`GET /public/stores/:storeId/checkout-marketing`
`storefront.coupons.list()`	`GET /public/stores/:storeId/checkout-marketing`
`storefront.coupons.validate()`	`POST /public/stores/:storeId/coupons/validate`
`storefront.cart.ensure()`	`POST/GET /public/stores/:storeId/storefront/cart`
`storefront.cart.addItem()`	`POST .../storefront/cart/:id/items`
`storefront.menus.list()` / `.get()`	`GET .../storefront/menus`
`storefront.blogs.*`	`GET .../storefront/blogs/...`
`storefront.pages.get()`	`GET .../storefront/pages/:handle`
`storefront.shop.get()`	`GET /public/stores/:storeId/shop`

Documentação por recurso:

Versão da API

import { STOREFRONT_API_VERSION } from '@corvex/theme-sdk';
// '2026-08'

Veja Versionamento.

Próximos passos

Erros comuns — leia antes de gerar código de tema
Contexto de página
Regras de escopo
Mapa de dados

Introdução

Temas

Seções

Guias

Exemplos

Storefront Components

Schema

CLI

Dados

SDK

Contratos

Marketplace

Visão geral — Data API

Storefront Data API

Regra de ouro

Três categorias de dados

High-level vs low-level

API simples (90% dos casos)

API avançada (futuro)

Rotas públicas mapeadas

Versão da API

Próximos passos

​Storefront Data API

​Regra de ouro

​Três categorias de dados

​High-level vs low-level

​API simples (90% dos casos)

​API avançada (futuro)

​Rotas públicas mapeadas

​Versão da API

​Próximos passos

Storefront Data API

Regra de ouro

Três categorias de dados

High-level vs low-level

API simples (90% dos casos)

API avançada (futuro)

Rotas públicas mapeadas

Versão da API

Próximos passos