Sabbiera
Una chiamata API fornisce un tenant sandbox isolato, conia una chiave API e avvia un firmatario demo: nessuna coda di accesso anticipato, nessuna configurazione manuale.
Cosa viene spedito quando richiedi un sandbox
Il flusso sandbox è una modalità sull''endpoint di registrazione self-service standard. Tutto ciò che ottieni è un vero inquilino sulla piattaforma reale: contrassegnato semplicemente con "isSandbox: true" e pre-seminato in modo che il tuo primo "curl" abbia esito positivo.
Inquilino isolato
Un nuovo tenant con il nome scelto, contrassegnato con `isSandbox: true`. Le chiavi Sandbox API non funzionano mai contro un altro inquilino e nessuna chiave di un altro inquilino funziona contro la tua. Chiave
API restituita una volta
La risposta di registrazione include la chiave `esk_test_…` completa. Viene mostrato una volta: memorizzalo nel gestore segreto del tuo server o coniane un altro da Amministratore → Sviluppatore → Chiavi API.
Firmatario demo seed
Un record cliente (`sandbox-signer-{yourTenantId}`) è precreato. Quando il seeding ha esito positivo, viene incluso `sampleTemplateId` in modo che la prima chiamata al server possa essere create-from-template.
Piano gratuito, nessuna configurazione di fatturazione
I tenant sandbox sono bloccati sul lato server del piano gratuito. La registrazione non tocca mai la pipeline di fatturazione e un `planId` nel corpo della richiesta viene ignorato quando è impostato `mode: sandbox`.
Webhooks + console per sviluppatori
Registra gli endpoint in Amministrazione → Sviluppatore → Webhook mentre sei connesso. Riproduci le consegne non riuscite e controlla le richieste API in Amministrazione → Sviluppatore → Console.
Scadenza avviso 30 giorni
L''inquilino porta con sé un suggerimento `expiresAt` (attualmente informativo: l''applicazione è un follow-up). Oggi non viene eliminato automaticamente nulla; il campo è lì per il futuro lavoro di pulizia.
Richiedi un sandbox in una sola richiesta
Prerequisiti: un indirizzo email valido e una password di almeno 8 caratteri. Output previsto: HTTP 201 con il tuo `tenantId`, `sandbox.apiKey` (mostrato una volta) e il `demoCustomerId` con seed.
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-…"
# }
# }Verifica la tua email di amministratore dalla tua casella di posta prima di accedere ad Admin. Il tasto API funziona immediatamente: la verifica accede solo alla console umana.
Dalla sandbox alla produzione
- 1
Rivendica la tua sandbox
POST /api/auth/register with `mode: sandbox`. Capture the returned API key in your secret store.
- 2
Chiama il API con il tasto sandbox
Conferma GET /api/v1/zapier/auth/test, quindi crea da modello e invia per firma. Registra webhooks in Amministrazione → Sviluppatore → Webhooks e guarda le consegne nella console.
- 3
Rivedi la checklist di integrazione
Conferma verifica della firma webhook, registrazione dell''ID di correlazione e idempotenza. Elenco di controllo completo nella console per sviluppatori in Amministrazione → Sviluppatore.
- 4
Iscriviti alla produzione
Quando sei pronto, registra un tenant di produzione separato tramite lo stesso endpoint con "mode: production" (o l''interfaccia utente di registrazione standard). Il tuo tenant sandbox rimane fermo per consentirti di continuare a eseguire i test.
Domande comuni
Richiedi il tuo sandbox in una sola chiamata
L''endpoint è attivo oggi. Il corpo della risposta include una chiave "esk_test_" che puoi confermare dal tuo server.