Skip to content

eSigKit · v1

Developer documentation

Everything you need to build with the eSigKit signature-management API — endpoints, authentication, webhooks, and language SDKs. Always in sync with the live spec.

API reference

Every endpoint, request schema, and response shape — generated directly from the production OpenAPI spec.

Read

Quickstart

Authenticate, render your first signature, and embed it in Gmail in under five minutes.

Read

Authentication

Cognito JWTs for browser apps, API keys for server-to-server. PKCE flow, token rotation, and the dashboard / admin client split.

Read

Errors

The full error envelope, status-code catalog, retry guidance per status, and the correlationId pattern for debugging.

Read

Rate limits

100 RPS stage-wide with 200 burst, plus the 429 + Retry-After contract and exponential-backoff client recipe.

Read

Idempotency

Optimistic concurrency on every mutable resource — version-based 409 handling and the read-modify-write loop pattern.

Read

Pagination

Cursor-based pagination on every list endpoint. Opaque base64 cursors, default + max page size, and the loop pattern.

Read

Webhooks

Stripe-event handling: HMAC signing scheme, 7-day dedup, retry semantics, and the event-type catalog.

Read

SDKs

Drop-in patterns for HTML email signatures, React hooks (useSignature), and Next.js server-component rendering.

Read

Base URLs

Three environments matching the SDLC. Use staging for integration tests; never run automated tests against production.

Stage Base URL Notes
Production https://api.esigkit.com/v1 Live customer traffic.
Staging https://api-test.esigkit.com/v1 Pre-prod validation.
Development https://api-dev.esigkit.com/v1 Sandbox — may break at any time.