# Sig.Surf REST API

Bron: https://sig.surf/nl/integrations/rest-api (Markdown-versie van de pagina)

Een JSON-API om handtekeningen te maken en medewerkers te beheren, met een OpenAPI-beschrijving op een vaste URL.

> Handtekeningen die via deze interface worden gemaakt, zijn voor Gmail en Google Workspace.

## Wat je kunt doen

- `POST /api/v1/signatures` zonder inloggegevens neemt een sjabloon-id of een handtekeningdocument plus veldwaarden aan, en geeft gerenderde HTML, platte tekst, waarschuwingen en een claimlink terug. Iemand logt later in en claimt de handtekening; niet-geclaimde handtekeningen verlopen na 30 dagen.
- Met een API-sleutel kun je de medewerkers van je organisatie opvragen en bijwerken.
- Vraag de sjablooncatalogus op.

## Conventies

- JSON erin en eruit. Fouten zien eruit als `{ "error": { "code", "message" } }` met de bijbehorende HTTP-status.
- API-sleutels beginnen met `ssk_`, handelen voor één organisatie en worden als bearer-token meegestuurd. Van elke sleutel wordt alleen een hash opgeslagen.
- Request-body's zijn beperkt tot 64 KiB. Voor anonieme aanroepers geldt een limiet op het aantal verzoeken, en je krijgt `429` met een `Retry-After`-header.
- Het OpenAPI 3.1-document staat op `/api/v1/openapi.json`.

Voor assistenten die MCP spreken: zie de [MCP-server](https://sig.surf/nl/integrations/mcp-server).
