Integrazioni

REST API di Sig.Surf

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.

Questa pagina è disponibile anche in Markdown.