Docs

Documentazione

sigillo sigilla i PDF con valore legale tramite il partner di firma svizzero SwissTrustLayer — come timestamp o firma elettronica qualificata (QES). Tre vie d'accesso condividono la stessa logica e la stessa contabilità dei crediti.

REST-API

Riferimento OpenAPI interattivo (Swagger UI) — prova ogni endpoint.

/docs/api →

Server MCP

Integra sigillo come strumento per agenti IA (Claude, ChatGPT, n8n).

/docs/mcp →

Token API

Crea un token nella dashboard — necessario per REST e MCP.

/app/tokens →

1. Autenticazione

Ogni chiamata usa un token Bearer dalla dashboard:

Authorization: Bearer sig_xxxxxxxx…

I token portano scope — seal:write include seal:read:

seal:readLeggere stato, download, saldo

seal:writeSigillare PDF (costa crediti)

billing:manageAcquistare crediti

account:manageGestione token (solo login web, non assegnabile ai token API)

2. Sigillare un PDF (REST)

Timestamp, sincrono — il PDF sigillato torna subito:

curl -X POST https://sigillo.ch/api/v1/seal/timestamp \
  -H "Authorization: Bearer sig_…" \
  -F pdf=@vertrag.pdf \
  -F signer_name=Daniel -F signer_surname=Schlager \
  --output sealed.pdf

QES (on_demand/mab) è asincrona: un 201 con un request_id, poi interroga lo stato finché è completed, e scarica.

→ Referenza REST

3. Da un agente IA (MCP)

sigillo è un server MCP ospitato con quattro strumenti: seal_pdf, seal_status, seal_download, seal_balance.

→ Guida MCP