Começar
Ambientes: sandbox e produção
Dois ambientes isolados, cada um com sua credencial, seus dados e seus webhooks.
Página em construção
Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.
| Ambiente | Base da API |
|---|---|
| Sandbox | https://api.sandbox.kodano.com.br/v1 |
| Produção | https://api.kodano.com.br/v1 |
- A credencial pertence a um ambiente. Token de um ambiente usado no outro responde
401 AUTH.TOKEN_INVALIDou403 AUTH.ENVIRONMENT_MISMATCH. - Cobranças, clientes, webhooks e eventos de um ambiente nunca aparecem no outro.
- Só existe
/v1: rota sem versão responde404 ROUTE.NOT_FOUND. Mudança que quebra contrato sai em/v2. - TLS 1.2 ou superior. Não há CORS: a API é para chamadas de servidor, nunca do navegador.
- Na fase de piloto, o acesso começa pelo sandbox; a produção é liberada depois da homologação.