Piaskownica
Jedno wywołanie API udostępnia izolowanego dzierżawcę piaskownicy, generuje klucz API i uruchamia osobę podpisującą wersję demonstracyjną — bez kolejki wczesnego dostępu i ręcznej konfiguracji.
Jakie statki zostaną dostarczone po odebraniu piaskownicy
Przepływ piaskownicy to tryb w standardowym samoobsługowym punkcie końcowym rejestracji. Wszystko, co dostajesz, to prawdziwy najemca na prawdziwej platformie — po prostu oznaczony jako „isSandbox: true” i wstępnie rozstawiony, aby Twoje pierwsze „curl” zakończyło się sukcesem.
Odosobniony najemca
Nowy najemca o wybranej przez Ciebie nazwie, oznaczony jako `isSandbox: true`. Klucze API piaskownicy nigdy nie działają przeciwko innemu dzierżawcy, a klucze żadnego innego dzierżawcy nie działają przeciwko Twojemu. Klucz
API powrócił raz
Odpowiedź rejestracyjna zawiera pełny klucz `esk_test_…`. Jest wyświetlany raz — przechowuj go w menedżerze tajnych serwerów lub utwórz inny z poziomu Administrator → Programista → Klucze API.
Rozpoczęty podpisujący demo
Jeden rekord klienta („podpisujący piaskownicę-{yourTenantId}`) jest wstępnie utworzony. Kiedy inicjowanie się powiedzie, dołączany jest `sampleTemplateId`, więc pierwsze wywołanie serwera może zostać utworzone na podstawie szablonu.
Plan bezpłatny, bez konfiguracji rozliczeń
Abonenci piaskownicy są zablokowani po stronie serwera w ramach bezpłatnego planu. Rejestracja nigdy nie wpływa na potok rozliczeń, a „planId” w treści żądania jest ignorowany, gdy ustawiony jest „tryb: piaskownica”.
Webhooks + konsola programisty
Zarejestruj punkty końcowe w Admin → Programista → Webhook po zalogowaniu. Odtwórz ponownie nieudane dostawy i sprawdź żądania API w Admin → Programista → Konsola.
Doradczy 30-dniowy okres ważności
Najemca zawiera wskazówkę „wygasa o godzinie” (obecnie ma charakter informacyjny — egzekwowanie prawa jest kontynuacją). Dzisiaj nic nie jest automatycznie usuwane; jest tam pole do przyszłego zadania sprzątania.
Odbierz piaskownicę w jednym żądaniu
Wymagania wstępne: prawidłowy adres e-mail i hasło składające się z co najmniej 8 znaków. Oczekiwany wynik: HTTP 201 z identyfikatorem `tenantId`, `sandbox.apiKey` (pokazanym raz) i zaszczepionym `demoCustomerId`.
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-…"
# }
# }Zweryfikuj swój adres e-mail administratora w skrzynce odbiorczej przed zalogowaniem się do konta administratora. Klawisz API działa natychmiast — weryfikacja umożliwia jedynie przejście do konsoli człowieka.
Od piaskownicy do produkcji
- 1
Odbierz swoją piaskownicę
POST /api/auth/register with `mode: sandbox`. Capture the returned API key in your secret store.
- 2
Zadzwoń do API za pomocą klawisza piaskownicy
Potwierdź GET /api/v1/zapier/auth/test, następnie utwórz-z-szablonu i wyślij do podpisania. Zarejestruj webhook w Admin → Programista → Webhook i oglądaj dostawy w konsoli.
- 3
Przejrzyj listę kontrolną integracji
Potwierdź weryfikację podpisu webhook, rejestrowanie identyfikatora korelacji i idempotencję. Pełna lista kontrolna w konsoli programisty w sekcji Administrator → Deweloper.
- 4
Zarejestruj się na produkcję
Kiedy będziesz gotowy, zarejestruj osobnego dzierżawcę produkcyjnego za pośrednictwem tego samego punktu końcowego, korzystając z „trybu: produkcja” (lub standardowego interfejsu użytkownika rejestracji). Twój najemca piaskownicy pozostaje na miejscu, dzięki czemu możesz kontynuować testowanie.
Częste pytania
Odbierz swoją piaskownicę podczas jednej rozmowy
Punkt końcowy jest dzisiaj aktywny. Treść odpowiedzi zawiera klucz `esk_test_`, który możesz potwierdzić na swoim serwerze.