🧪 Ambiente de Testes

Sandbox

Teste suas integrações sem tocar em dados reais. O ambiente sandbox é completamente isolado por empresa — mesma URL, chave diferente.

O que é o Sandbox

Cada empresa pode ter um tenant espelho de sandbox — um espaço completamente separado pré-populado com funcionários e batidas de teste. Chaves com prefixo mp360_test_ operam sobre esses dados. Chaves mp360_sk_ operam sobre produção.

Comparação de ambientes

ProduçãoSandbox

Prefixo da chavemp360_sk_...mp360_test_...

Base URLapi.meuponto360.com/v1api.meuponto360.com/v1

DadosDados reais da empresa8 funcionários + histórico de ponto

Afeta produçãoSimNão

Reset disponível—Sim (via dashboard ou API)

Criando uma chave Sandbox

1No Dashboard, acesse Configurações → API e Integrações.
2Clique em Nova chave e selecione o ambiente Sandbox no toggle.
3Copie a chave gerada — ela terá prefixo mp360_test_.

💡

Na primeira criação de uma chave sandbox, o sistema automaticamente cria o tenant espelho e popula os dados de teste. Isso leva alguns segundos.

Dados de teste disponíveis

Dado	Quantidade	Detalhes
Unidade	1	Sede São Paulo
Departamentos	3	Tecnologia, Recursos Humanos, Operações
Funcionários	8	Ana Souza (MANAGER), Carlos Lima, Fernanda Rocha, Marcos Oliveira (SUPERVISOR), Juliana Mendes, Ricardo Santos, Patrícia Costa, Bruno Alves
Registros de ponto	~240	30 dias úteis · horário regular 08:00–17:00 · Carlos Lima com horas extras (até 19:00 seg/qua/sex) · Patrícia Costa com 2 faltas recentes
Banco de horas	2	Carlos Lima: +3h · Patrícia Costa: −2h
Escala de trabalho	1 template · 8 atribuições	Comercial 08h–17h · todos os funcionários · vigência a partir de 60 dias atrás
Solicitações de ajuste	3	PENDING (Patrícia · atestado médico) · APPROVED (Ricardo · hora extra) · REJECTED (Bruno · correção de ponto)

Usando a chave sandbox

Substitua a chave de produção pela chave sandbox em qualquer requisição — o comportamento é idêntico, mas os dados são isolados.

# Listar funcionários de teste
curl https://api.meuponto360.com/v1/employees \
  -H "x-api-key: mp360_test_sua_chave_sandbox"

# Registrar uma batida de teste
curl -X POST https://api.meuponto360.com/v1/time-entries \
  -H "x-api-key: mp360_test_sua_chave_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"employeeId": "id_funcionario_teste", "timestamp": "2026-03-16T08:00:00Z", "type": "ENTRY"}'

Resetar o Sandbox

Restaure os dados ao estado inicial a qualquer momento — útil para repetir cenários de teste do zero.

Via Dashboard

Na página API e Integrações, clique em Resetar Sandbox no card "Dados de Teste".

Via API Pública

POST /v1/sandbox/reset

Requer API key de sandbox (mp360_test_*). Ideal para automação de testes.

⚠️

O reset apaga todos os dados do sandbox (funcionários, batidas, banco de horas) e recria do zero. A operação leva ~2 segundos.

curl -X POST https://api.meuponto360.com/v1/sandbox/reset \
  -H "x-api-key: mp360_test_sua_chave_sandbox"

Comportamento no Sandbox

• Todos os endpoints funcionam exatamente como em produção — mesma validação, mesmos erros.
• E-mails de notificação não são enviados no sandbox.
• Registros criados no sandbox aparecem no log de auditoria marcados como sandbox.
• Dados de sandbox nunca aparecem nos relatórios de produção.
• O sandbox pode ser resetado quantas vezes for necessário.

← Autenticação Registros de Ponto →