> ## Documentation Index
> Fetch the complete documentation index at: https://laas.mippo.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Como plataformas autenticam chamadas server-to-server na API do Supercosmos for Platforms com chaves de API e como o painel do desenvolvedor usa tokens JWT do Clerk para sessão.

## 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`.

```bash theme={null}
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

1. Faça login no seu [painel do desenvolvedor](https://partners.mippo.io/partner/api-keys)
2. Clique em **Generate key**
3. Copie a chave crua — ela é exibida **apenas uma vez** (estilo Stripe)

> [!WARNING]
>
> 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.

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

Endpoints de gerenciamento da conta (`/laas/partner/*`) usam autenticação JWT do Clerk via sua sessão de login existente na Supercosmos. Esses endpoints são chamados pelo proxy do frontend Next.js, não pelo seu código de integração.

## 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:

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.