# Modo Sandbox

## O que é

O modo sandbox permite testar a integração com a API usando **dados sintéticos**. As respostas mantêm a mesma estrutura e tipos de dados da produção, mas com valores fictícios.

## Como funciona

Sandbox é uma **propriedade da conta do usuário**, configurada pelo administrador no Portal Administrativo. Não é algo que o desenvolvedor ativa por requisição.

1. O administrador marca a conta como sandbox via Portal Administrativo
2. As credenciais dessa conta — **API Key** (`X-Apikey` / `api_key`) ou **token JWT** (`POST /auth/token`) — passam a carregar a marcação sandbox
3. O API Gateway injeta automaticamente o header `X-Sandbox` em todas as requisições
4. Os serviços retornam dados sintéticos em vez de consultar as bases reais

> **Nenhuma ação é necessária no código de integração.** Se a conta é sandbox, todas as respostas já serão sintéticas automaticamente, seja a autenticação por API Key ou por JWT.

## Comportamento

- Retorna dados com **tipos e estrutura idênticos** à produção
- Valores são fictícios mas plausíveis
- **Não consome quota** nem rate limit
- Funciona em todos os endpoints de localização e roteamento

## Quando usar

- Desenvolvimento e prototipação
- Testes de integração
- Pipelines de CI/CD
- Validação de parsing de resposta

> Solicite ao administrador a ativação do modo sandbox na sua conta para começar a receber dados sintéticos.

## SDK

O SDK Python detecta automaticamente quando a conta está em modo sandbox e exibe um aviso durante a inicialização:

```
[PrismaData] Atenção: conta em modo sandbox — respostas contêm dados sintéticos.
```

---

- Índice geral: https://prismadata.io/llms.txt
- Documentação Redoc interativa: https://prismadata.io/redoc.html