Skip to main content
A API da Salvy oferece dois ambientes: sandbox e produção. Você não precisa trocar a URL da API para alternar entre eles. O ambiente é definido pela chave de API utilizada.
  • Produção: executa ações reais, como envio de SMS, e-mails, notificações e cobranças.
  • Sandbox: ambiente isolado para desenvolvimento e testes. Nenhuma ação externa real (SMS, e-mail, notificações e outras) é executada.
Você pode usar a mesma URL em desenvolvimento e produção. Para trocar de ambiente, basta trocar a chave de API.

​
Como o ambiente é escolhido

Você não muda o endereço nem envia nenhum parâmetro especial. Basta usar a chave do ambiente desejado no cabeçalho Authorization. Você identifica o ambiente e o tipo da chave pelo prefixo:
Chaves de API de empresa anteriores a 07/2026 não têm prefixo.
Chaves de organização são emitidas apenas em produção por enquanto (prefixo salvy_org_prod_). O suporte a sandbox para chaves de organização será adicionado quando disponível.
Produção
Sandbox

​
Comportamento no sandbox

Uma resposta 2xx significa que a Salvy processou a requisição com sucesso. No sandbox, isso não significa que uma ação real (como o envio de uma mensagem) foi executada para um destinatário real.
Nenhuma operação no sandbox gera cobrança. Tudo o que você cria no sandbox fica isolado de produção. Para começar a testar, crie uma chave de sandbox. O passo a passo está no guia de Chaves de API.

​
Boas práticas e segurança

Não misture as chaves. Como o endereço é o mesmo nos dois ambientes, usar uma chave de produção em um teste executa ações reais, incluindo envios e cobranças. Confirme sempre o prefixo da chave antes de usá-la.
  • Use chaves de sandbox (salvy_test_) em desenvolvimento e testes automatizados.
  • Guarde as chaves de produção e de sandbox separadamente e com nomes descritivos. Veja Chaves de API.
  • Valide toda a sua integração no sandbox antes de trocar para uma chave de produção.