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.
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.

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.

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?