Sandbox
Como obter acesso e testar sem tocar na produção.
A sandbox é um servidor separado da produção, na mesma versão dela, com dados de demonstração que voltam ao estado inicial toda semana. É ali que você desenvolve e testa a integração inteira, inclusive a escrita, sem risco para os dados reais da empresa. Nada sai da sandbox: e-mail, WhatsApp, cobrança, nota fiscal e webhooks ficam registrados como bloqueados.
Como obter acesso
- Peça a quem administra a conta (ou entre com um perfil que pode gerenciar chaves) e abra Configurações › Chaves de API, na produção.
- Clique em "Gerar chave de sandbox". A chave começa com tnk_sbx_ e aparece uma única vez: guarde-a num cofre de segredos.
- Troque o endereço base da sua integração para o endereço da sandbox abaixo e envie a chave como sempre (Authorization: Bearer).
- Quando a integração estiver pronta, gere uma chave de produção e troque endereço e chave. O código não muda: o contrato é o mesmo.
Endereço da sandbox
Endereço da sandbox
https://sandbox.tenka.app.br/api/v1As regras da sandbox
| Limite | Valor | Nota |
|---|---|---|
| Onde a chave vale | tnk_sbx_ | Só na sandbox. A produção recusa a chave de sandbox, e a sandbox recusa a chave de produção, sempre com a explicação no corpo do erro. |
| Validade da chave (dias) | 90 | Vencida, a sandbox responde 403 dizendo que venceu; gere outra. |
| Chamadas por chave por dia | 1000 | O contador volta a zero à meia-noite. O teto por minuto da produção também vale. |
| Dados recriados a cada (dias) | 7 | Todo domingo de madrugada a base volta à demonstração: o que você gravou some. Não guarde nada importante na sandbox. |
Erros que só a sandbox devolve
| HTTP | Nota | |
|---|---|---|
| 403 | esta e uma chave de SANDBOX (tnk_sbx_) e so vale no ambiente de sandbox — use o endereco da sandbox, ou gere uma chave de producao em Configuracoes > Chaves de API | |
| 403 | este e o ambiente de SANDBOX e so aceita chave de sandbox (tnk_sbx_) — gere uma em Configuracoes > Chaves de API > Gerar chave de sandbox; a sua chave de producao nunca deve ser usada aqui | |
| 403 | esta chave de sandbox venceu — gere outra em Configuracoes > Chaves de API (validade de 90 dias) | |
| 429 | limite diário da chave de sandbox atingido — o contador volta a zero à meia-noite | Retry-After: 3600 |
Nunca use a chave de produção para testar: se ela vazar do ambiente de teste, ela abre os dados reais da empresa. A chave de sandbox só abre dados de demonstração.