Ontwikkelaars

Zandbak

Eén API-oproep voorziet in een geïsoleerde sandbox-tenant, mint een API-sleutel en zaait een demo-ondertekenaar - geen wachtrij voor vroege toegang, geen handmatige installatie.

Wat wordt verzonden als je een sandbox claimt

De sandboxstroom is een modus op het standaard zelfbedieningsregistratie-eindpunt. Alles wat je krijgt is een echte tenant op het echte platform - gewoon gemarkeerd als ''isSandbox: true'' en vooraf gezaaid zodat je eerste ''curl'' slaagt.

🏷️

Geïsoleerde huurder

Een nieuwe tenant met de door u gekozen naam, gemarkeerd met `isSandbox: true`. Sandbox-API-sleutels werken nooit tegen een andere tenant, en de sleutels van een andere tenant werken niet tegen de uwe.

🔑

API-sleutel is één keer geretourneerd

Het registratieantwoord bevat de volledige `esk_test_…` sleutel. Het wordt één keer getoond: sla het op in de geheime manager van uw server, of maak een andere via Beheerder → Ontwikkelaar → API Sleutels.

👤

Geplaatste demo-ondertekenaar

Eén klantrecord (`sandbox-signer-{yourTenantId}`) is vooraf gemaakt. Wanneer het seeden slaagt, wordt `sampleTemplateId` opgenomen, zodat de eerste serveraanroep vanuit een sjabloon kan worden gemaakt.

🆓

Gratis abonnement, geen factureringsinstellingen

Sandbox-tenants zijn vergrendeld op de serverkant van het gratis abonnement. Registratie raakt nooit de factureringspijplijn, en een `planId` in de hoofdtekst van het verzoek wordt genegeerd wanneer `mode: sandbox` is ingesteld.

🔔

Webhook''s + ontwikkelaarsconsole

Registreer eindpunten in Beheerder → Ontwikkelaar → Webhook''s terwijl u bent aangemeld. Speel mislukte leveringen opnieuw af en inspecteer API-verzoeken in Beheerder → Ontwikkelaar → Console.

⏳

Adviesvervaldatum van 30 dagen

De huurder heeft een `expiresAt`-hint (momenteel informatief – handhaving is een vervolg). Niets wordt vandaag automatisch verwijderd; het veld is er voor de toekomstige opruimklus.

Claim een ​​sandbox in één verzoek

Vereisten: een geldig e-mailadres en een wachtwoord van meer dan 8 tekens. Verwachte uitvoer: HTTP 201 met uw `tenantId`, `sandbox.apiKey` (één keer weergegeven) en de geplaatste `demoCustomerId`.

bash
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-…"
#   }
# }

Verifieer uw admin-e-mailadres vanuit uw inbox voordat u zich aanmeldt bij Admin. De API-sleutel werkt onmiddellijk: verificatie gaat alleen via de menselijke console.

Van sandbox tot productie

  1. 1

    Claim je sandbox

    POST /api/auth/register with `mode: sandbox`. Capture the returned API key in your secret store.

  2. 2

    Bel de API met de sandbox-sleutel

    Bevestig GET /api/v1/zapier/auth/test, maak vervolgens een sjabloon aan en verzend het ter ondertekening. Registreer webhook''s in Beheer → Ontwikkelaar → Webhook''s en bekijk leveringen in de console.

  3. 3

    Bekijk de integratiechecklist

    Bevestig webhook handtekeningverificatie, loggen van correlatie-ID''s en idempotentie. Volledige checklist in de ontwikkelaarsconsole onder Beheerder → Ontwikkelaar.

  4. 4

    Meld je aan voor productie

    Wanneer u klaar bent, registreert u een afzonderlijke productietenant via hetzelfde eindpunt met `mode: production` (of de standaard aanmeldingsinterface). Uw sandboxtenant blijft op zijn plaats, zodat u kunt blijven testen.

Veelgestelde vragen

Claim uw sandbox in één gesprek

Het eindpunt is vandaag live. De antwoordtekst bevat een `esk_test_` sleutel die u kunt bevestigen vanaf uw server.