Caja de arena
Una llamada API proporciona un inquilino de espacio aislado, crea una clave API y genera un firmante de demostración: sin cola de acceso temprano ni configuración manual.
Qué se envía cuando reclamas un sandbox
El flujo de espacio aislado es un modo en el punto final de registro de autoservicio estándar. Todo lo que obtienes es un inquilino real en la plataforma real: simplemente marcado como "isSandbox: true" y presembrado para que tu primer "curl" tenga éxito.
Inquilino aislado
Un nuevo inquilino con el nombre elegido, marcado como "isSandbox: true". Las claves Sandbox API nunca funcionan contra otro inquilino, y ninguna clave de otro inquilino funciona contra la suya.
API clave devuelta una vez
La respuesta de registro incluye la clave `esk_test__…` completa. Se muestra una vez: guárdelo en el administrador secreto de su servidor o cree otro desde Admin → Desarrollador → API Claves.
Firmante de demostración inicial
Un registro de cliente (`sandbox-signer-{yourTenantId}`) está creado previamente. Cuando la inicialización se realiza correctamente, se incluye `sampleTemplateId` para que la primera llamada al servidor pueda crearse desde la plantilla.
Plan gratuito, sin configuración de facturación
Los inquilinos de Sandbox están bloqueados en el lado del servidor del plan gratuito. El registro nunca afecta el proceso de facturación y un `planId` en el cuerpo de la solicitud se ignora cuando se establece `mode: sandbox`.
Webhooks + consola de desarrollador
Registre los puntos finales en Administrador → Desarrollador → Webhook mientras esté conectado. Reproduzca las entregas fallidas e inspeccione las solicitudes API en Administrador → Desarrollador → Consola.
Advertencia de vencimiento de 30 días
El inquilino lleva una pista "expiresAt" (actualmente informativa; la aplicación de la ley es un seguimiento). Hoy nada se elimina automáticamente; el campo está ahí para el futuro trabajo de limpieza.
Reclame una zona de pruebas en una sola solicitud
Requisitos previos: una dirección de correo electrónico válida y una contraseña de más de 8 caracteres. Resultado esperado: HTTP 201 con su `tenantId`, `sandbox.apiKey` (que se muestra una vez) y el `demoCustomerId` inicializado.
curl -sS -X POST https://api.endorsedsign.com/api/auth/register \
-H 'Content-Type: application/json' \
-d '{
"tenantName": "Acme Dev Sandbox",
"adminEmail": "you@acme.example",
"password": "your-strong-password",
"mode": "sandbox"
}' | jq '.data | { tenantId, sandbox }'
# {
# "tenantId": "acme-dev-sandbox",
# "sandbox": {
# "apiKey": "esk_test_…", # capture this now — shown once
# "keyPrefix": "esk_test_…",
# "keyId": "…",
# "scopes": ["documents:write", …],
# "demoCustomerId": "sandbox-signer-acme-dev-sandbox",
# "demoCustomerName": "Sandbox Signer",
# "expiresAt": "2026-…"
# }
# }Verifique su correo electrónico de administrador desde su bandeja de entrada antes de iniciar sesión en Administrador. La tecla API funciona inmediatamente: la verificación solo activa la consola humana.
De sandbox a producción
- 1
Reclama tu zona de pruebas
POST /api/auth/register with `mode: sandbox`. Capture the returned API key in your secret store.
- 2
Llame al API con la clave sandbox
Confirme GET /api/v1/zapier/auth/test, luego cree desde plantilla y envíe para firmar. Registre webhooks en Admin → Developer → Webhooks y vea las entregas en la consola.
- 3
Revise la lista de verificación de integración
Confirmar webhook verificación de firma, registro de identificación de correlación e idempotencia. Lista de verificación completa en la consola de desarrollador en Administrador → Desarrollador.
- 4
Regístrese para producción
Cuando esté listo, registre un inquilino de producción independiente a través del mismo punto final con "modo: producción" (o la interfaz de usuario de registro estándar). El inquilino de su zona de pruebas permanece para que usted pueda seguir realizando pruebas.
Preguntas comunes
Reclama tu zona de pruebas en una sola llamada
El punto final está activo hoy. El cuerpo de la respuesta incluye una clave `esk_test_` que puede confirmar desde su servidor.