Obter as chaves API
Tipos de chave Rivox, armazenamento seguro, rotação e scopes.
Nesta página
As chaves API são geridas no dashboard, em Developers → API keys, e são sempre específicas de uma conta e de um ambiente.
Tipos de chave
| Prefixo | Tipo | Utilização |
|---|---|---|
sk_test_… | Secreta, sandbox | Servidor, testes |
sk_live_… | Secreta, live | Servidor, tráfego real |
pk_test_… / pk_live_… | Publicável | Identificação no cliente |
Apenas chaves secretas autenticam a API
Chamadas server-to-server exigemsk_…. Uma chave publicável devolve invalid_api_key.Armazenamento e rotação
- A chave completa é mostrada uma única vez, no momento da criação.
- A Rivox guarda apenas o hash da chave — não é possível recuperá-la depois.
- Em caso de exposição, revogue a chave e emita uma nova imediatamente.
- Guarde chaves em variáveis de ambiente ou num gestor de segredos.
Scopes
Cada chave transporta scopes verificados em todos os endpoints, por exemplo accounts:read. Se o scope necessário estiver em falta, a API devolve permission_error com o código insufficient_scope.