Skip to main content

​
Pré-requisitos

​
Passo 1 — Autenticação

Faça login com email e senha para obter a sessão: 
curl -c cookies.txt -X POST https://api.global.komprai.dev/auth/sign-in/email \
  -H "Content-Type: application/json" \
  -d '{"email": "seu@email.com", "password": "sua-senha"}'
O cookie better-auth.session_token será salvo em cookies.txt e usado automaticamente nos próximos requests.

​
Passo 2 — Busque seu usuário

curl -b cookies.txt https://api.global.komprai.dev/api/users/me
Resposta esperada: 
{
  "user": {
    "id": "...",
    "email": "seu@email.com",
    "name": "Seu Nome",
    "role": "user"
  },
  "session": { ... }
}

​
Passo 3 — Crie uma store

curl -b cookies.txt -X POST https://api.global.komprai.dev/api/stores \
  -H "Content-Type: application/json" \
  -d '{"name": "Minha Loja", "active": true}'

​
Passo 4 — Consulte ofertas de uma região

curl -b cookies.txt https://api.sa-east-1.komprai.dev/api/catalog/offers
Cada região tem sua própria instância do Catalog API. Use api.sa-east-1.komprai.dev para São Paulo ou api.us-east-1.komprai.dev para North Virginia.

​
Próximos passos

Core API

Explore stores, providers, billing e SSO.

Catalog API

Publique e consulte ofertas por região.