Vai al contenuto
Centro assistenza

Categorie

Cerca nel Centro assistenzaCtrl K
In questa pagina

Creare un'app o collegare dei webhook

Crea un'applicazione OAuth che altri utenti Drime collegano al proprio account, ricevi webhook e gli eventi di Drime Sign sul tuo server.

Aggiornato Web

Per usare l'API Drime sul tuo account basta un token personale: consulta Creare un token API. Per creare un'app che altri utenti Drime collegano ai propri account, crea un'applicazione OAuth: i tuoi utenti la approvano su Drime e l'app non vede mai la loro password.

#Creare un'applicazione OAuth

Qualsiasi utente che ha effettuato l'accesso può creare applicazioni dal portale sviluppatori, da Le mie applicazioni, poi Crea applicazione.

Il modulo Crea applicazione del portale sviluppatori con i tre tipi di applicazione

Per prima cosa scegli cosa stai creando:

Scelta

Per

Un sito web o un server

Ricevi una chiave segreta da tenere sul tuo server.

Un’app desktop o mobile

Installata sui dispositivi dei tuoi utenti, quindi niente chiave segreta.

Uno script, solo per me

Un piccolo strumento che esegui tu.

Poi scegli di cosa ha bisogno l'applicazione: Una cartella dedicata (vede sempre e solo una cartella, creata nel Drive) oppure Tutto il Drive.

Buono a sapersi:

  • Puoi creare fino a 25 applicazioni.

  • Una nuova applicazione funziona per un massimo di 25 utenti. Per aprirla a più persone, usa Aprirla a tutti, poi Invia per la revisione: Drime risponde entro 24 ore.

  • I token di accesso durano 1 ora e i token di aggiornamento 90 giorni.

  • Le applicazioni di terze parti non possono mai accedere a un Vault.

Le applicazioni di tipo Un sito web o un server possono anche ricevere webhook quando vengono creati o eliminati file in un account collegato. Ogni notifica è firmata nell'header X-Drime-Signature.

#Webhook di Drime Sign

In Impostazioni > Sviluppatori > Webhook (Notifiche HTTP per gli eventi di Drime Sign.), fai clic su Aggiungi un webhook per far avvisare il tuo server quando, ad esempio:

  • un documento viene inviato, completato o rifiutato;

  • un firmatario visualizza, firma o rifiuta;

  • viene creato un modello.

La sezione Webhook delle impostazioni Sviluppatori con Aggiungi un webhook

Ogni notifica è firmata con un secret (X-Drime-Signature, HMAC SHA-256). Una notifica non riuscita viene ritentata fino a 10 volte nell'arco di circa 34 ore. Puoi usare Invia un test e Cambia il segreto, e controllare le Consegne.

#Incorporare un modulo di firma nel tuo sito web

In Impostazioni > Sviluppatori > Incorporamento puoi permettere ai visitatori di firmare documenti senza lasciare il tuo sito web, con il widget <drime-sign-form>. Aggiungi i tuoi domini in Domini consentiti: senza alcun dominio, l'incorporamento è disattivato.

#Passi successivi

Ti è stato utile?