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

# Ambientes

> Entenda os ambientes de sandbox e produção da API da Salvy e como alternar entre eles

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.

<Tip>
  Você pode usar a mesma URL em desenvolvimento e produção. Para trocar de
  ambiente, basta trocar a chave de API.
</Tip>

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

| Tipo de chave | Produção          | Sandbox       |
| ------------- | ----------------- | ------------- |
| Empresa       | `salvy_prod_`     | `salvy_test_` |
| Organização   | `salvy_org_prod_` | —             |

<Warning>Chaves de API de empresa anteriores a 07/2026 não têm prefixo.</Warning>

<Note>
  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.
</Note>

```bash Produção theme={null}
curl -X GET "https://api.salvy.com.br/api/v3/cost-centers" \
-H "Authorization: Bearer salvy_prod_sua_chave_aqui"
```

```bash Sandbox theme={null}
curl -X GET "https://api.salvy.com.br/api/v3/cost-centers" \
-H "Authorization: Bearer salvy_test_sua_chave_aqui"
```

## Comportamento no sandbox

<Warning>
  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.
</Warning>

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](/api-reference/v3/api-keys).

## Boas práticas e segurança

<Warning>
  **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.
</Warning>

* 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](/api-reference/v3/api-keys).
* Valide toda a sua integração no sandbox antes de trocar para uma chave de produção.