🧪 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 empresa5 funcionários de teste

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
Funcionários	5	Funcionário Teste 01 a 05, status ACTIVE
Registros de ponto	~100–120	30 dias corridos, dias úteis, 4 batidas/dia (08:00, 12:00, 13:00, 17:00)

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 (JWT)

POST /api-keys/sandbox/reset

Requer autenticação JWT (Bearer token do dashboard).

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 →