Per iniziare
Se desideri aggiungere la firma elettronica al tuo sistema, l'API di integrazione di Swisscom Sign ti offre un flusso orientato al backend per creare, configurare, rilasciare e monitorare i processi di firma.
Questa guida segue lo stesso percorso della documentazione di riferimento Swisscom: comprendere il ciclo di vita, scegliere uno stile di integrazione, autenticarsi con OAuth2 e testare nella sandbox prima del passaggio in produzione. Prima della messa in produzione, consulta i termini e condizioni.
Modalità di integrazione
Esistono due modelli di integrazione comuni:
- Utilizzo delle credenziali del cliente. In questo modello, gli utenti si abbonano e gestiscono l'accesso per la propria organizzazione.
- Utilizzo delle credenziali della tua piattaforma. In questo modello, la tua applicazione offre la firma come parte del tuo prodotto e gestisce centralmente l'accesso alle API.
Per configurazioni avanzate come domini personalizzati, certificati personalizzati, materiale crittografico o SSO, Swisscom prevede un processo di onboarding dedicato.
Flusso di integrazione tipico
- Crea un processo con
POST /api/process. - Allega uno o più documenti PDF.
- Rilascia il processo direttamente oppure consegnalo all'interfaccia di configurazione.
- Apri il flusso di firma per un firmatario specifico se hai bisogno di un deep link.
- Interroga l'endpoint di stato fino al completamento del processo.
- Scarica il documento finale e la traccia di audit.
Consulta Concetti per il ciclo di vita completo e la reference degli endpoint.
Utilizzare l'API Explorer
La scheda API Explorer in questa applicazione carica il contratto OpenAPI live direttamente da Swisscom e offre un client REST interattivo per l'autenticazione, l'ispezione dei payload delle richieste e il test degli endpoint.