Criar Ambiente Sandbox

Cria ambiente sandbox isolado para testes. Expira em 30 dias. Limite: 1 sandbox por empresa. Requer scope sandbox:access. Para API keys de cliente (sem empresa_id fixo), enviar empresa_id no body.

Autenticação:

🔑 API Key

Corpo

empresa_idnumber

ID da empresa para criar o sandbox (obrigatório para API keys de cliente)

Respostas

{
  "ok": true,
  "data": {
    "sandbox": {
      "empresa_id": 100,
      "nome_fantasia": "[SANDBOX] Empresa Teste",
      "is_sandbox": true,
      "sandbox_expires_at": "2026-03-06T10:00:00Z"
    },
    "message": "Sandbox criado com sucesso. Use o header X-Sandbox-Mode: true"
  }
}

Sandbox Mode

curl --request POST \
  'https://rep-gestor.youuponto.com/api/v1/sandbox/criar' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "empresa_id": 1
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "sandbox": {
      "empresa_id": 100,
      "nome_fantasia": "[SANDBOX] Empresa Teste",
      "is_sandbox": true,
      "sandbox_expires_at": "2026-03-06T10:00:00Z"
    },
    "message": "Sandbox criado com sucesso. Use o header X-Sandbox-Mode: true"
  }
}