API v1

Documentação da API

REST · JSON · Cada chamada debita créditos da sua carteira.

Autenticação

Use o header Authorization: Bearer <prefix>.<secret> com os valores gerados em Parceiros → API Keys.

Authorization: Bearer erv_live_xxxx.SEU_SECRET

Endpoints

POST/api/public/v1/consume

Consome créditos da carteira do parceiro. Retorna saldo restante.

Exemplo · cURL

curl -X POST https://stellar-resell-hub.lovable.app/api/public/v1/consume \
  -H "Authorization: Bearer erv_live_xxxx.SEU_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1}'

Formato de resposta

200 · Sucesso

{
  "ok": true,
  "credits_charged": 1,
  "balance": 99,
  "latency_ms": 42
}

Erros

401 invalid_api_key
403 key_revoked / partner_suspended
402 insufficient_credits
400 invalid_body

Os endpoints serão ativados na próxima fase do projeto.