POST
/api/v1/sandbox/criar

Criar Ambiente Sandbox

Cria ambiente sandbox isolado para testes. Expira em 30 dias. Limite: 1 sandbox por empresa. Requer scope sandbox:access.
Autenticação:
🔑 API Key

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"
  }
}
curl --request POST \
  'http://localhost:3000/api/v1/sandbox/criar' \
  --header 'x-api-key: yk_sua_api_key'

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"
  }
}