Autenticação com chaves de API e JWT do Clerk

Chaves de API

Todos os endpoints da API do Supercosmos for Platforms (/v1/laas/*) exigem uma chave de API enviada no header X-Mippo-API-Key.

curl https://api.mippo.io/v1/laas/kyc/submit \
  -H "X-Mippo-API-Key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "cpf": "123.456.789-09", "biometricHash": "sha256:abc" }'

Formatos de chave

Prefixo	Ambiente	Uso
`sk_live_`	Produção	BRL real, KYC real
`sk_test_`	Sandbox	Pagamentos simulados, KYC de teste

Gerando chaves

Faça login no seu painel do desenvolvedor

Clique em Generate key

Copie a chave crua — ela é exibida apenas uma vez (estilo Stripe)

Trate as chaves de API como senhas. Nunca as commite em repositórios de código. Rotacione imediatamente em caso de exposição. Todas as chamadas à API devem partir do seu backend — nunca do seu frontend.

Erros

Código	Significado
`401`	Chave de API ausente ou inválida
`403`	Chave revogada ou conta suspensa
`429`	Limite de taxa excedido (100 req/min por chave)

Todas as respostas de erro seguem o formato:

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or has been revoked."
  }
}

Introdução

Guias

Autenticação com chaves de API e JWT do Clerk

Chaves de API

Formatos de chave

Gerando chaves

Autenticação do painel do desenvolvedor (JWT do Clerk)

Erros

​Chaves de API

​Formatos de chave

​Gerando chaves

​Autenticação do painel do desenvolvedor (JWT do Clerk)

​Erros

Chaves de API

Formatos de chave

Gerando chaves

Autenticação do painel do desenvolvedor (JWT do Clerk)

Erros