# REST API di Sig.Surf

Fonte: https://sig.surf/it/integrations/rest-api (versione Markdown della pagina)

Un'API JSON per creare firme e gestire i dipendenti, con una descrizione OpenAPI a un URL stabile.

> Le firme create tramite questa interfaccia sono per Gmail e Google Workspace.

## Cosa puoi fare

- `POST /api/v1/signatures` senza credenziali accetta l'id di un modello o un documento di firma più i valori dei campi, e restituisce HTML generato, testo normale, avvisi e un link di rivendicazione. Qualcuno accede in seguito e la rivendica; le firme non rivendicate scadono dopo 30 giorni.
- Con una chiave API, elenca e aggiorna i dipendenti della tua organizzazione.
- Elenca il catalogo dei modelli.

## Convenzioni

- JSON in entrata e in uscita. Gli errori hanno la forma `{ "error": { "code", "message" } }` con lo stato HTTP corrispondente.
- Le chiavi API iniziano con `ssk_`, agiscono per una sola organizzazione e vengono inviate come bearer token. Di ogni chiave viene conservato solo un hash.
- Il corpo delle richieste è limitato a 64 KiB. Per le chiamate anonime c'è un limite di frequenza, e ricevi `429` con un'intestazione `Retry-After`.
- Il documento OpenAPI 3.1 si trova su `/api/v1/openapi.json`.

Per gli assistenti che parlano MCP, guarda il [server MCP](https://sig.surf/it/integrations/mcp-server).
