Começando

Descubra a URL base da sua loja, faça login e realize sua primeira chamada autenticada em minutos.

3 min de leituraAtualizado em 14 de agosto de 2026

A API do Ecom é REST, com respostas em JSON e códigos de status HTTP convencionais. Cada loja é um tenant isolado, identificado pelo subdomínio. Este guia leva você do zero à primeira requisição autenticada.

1. Identifique a URL base

Toda requisição usa o subdomínio da sua loja como URL base. Em produção é o domínio da loja; em desenvolvimento você pode enviar o header X-Tenant para resolver o tenant.

bash

# Produção — o subdomínio resolve a loja
https://minha-loja.ecom.app

# Desenvolvimento — resolve a loja pelo header
curl http://localhost:4000/health -H "X-Tenant: minha-loja"

2. Faça login no painel

O login do painel devolve um cookie httpOnly (ecom_token). Guarde o cookie e reutilize-o nas próximas chamadas de administração.

bash

curl -X POST "https://minha-loja.ecom.app/auth/login" \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{"email":"admin@minha-loja.com","senha":"sua-senha"}'

3. Chame um endpoint autenticado

bash

curl "https://minha-loja.ecom.app/products" -b cookies.txt

Recebeu 200 com { success: true, data: [...] }? Está tudo pronto. Explore a Referência da API para todos os endpoints.

PróximoAutenticação