Créer une application ou connecter des webhooks

Pour utiliser l'API Drime sur votre propre compte, un token personnel suffit : voir Créer un token d'API. Pour créer une application que d'autres utilisateurs de Drime connectent à leur compte, créez une application OAuth : vos utilisateurs l'approuvent sur Drime, et elle ne voit jamais leur mot de passe.

#Créer une application OAuth

Tout utilisateur connecté peut créer des applications depuis le portail développeur, Mes applications, puis Créer une application.

Vous choisissez d'abord ce que vous créez :

Vous choisissez ensuite ce dont l'application a besoin : Un dossier à elle (elle ne voit jamais qu'un seul dossier, créé dans le Drive) ou Tout le Drive.

Bon à savoir :

• Vous pouvez créer jusqu'à 25 applications.

• Une nouvelle application fonctionne pour 25 utilisateurs au plus. Pour l'ouvrir à davantage de personnes, utilisez Ouvrir à tous, puis Envoyer pour revue : Drime répond sous 24 heures.

• Les tokens d'accès durent 1 heure, et les tokens d'actualisation 90 jours.

• Les applications tierces ne peuvent jamais accéder à un Vault.

Les applications de type Un site web ou un serveur peuvent aussi recevoir des webhooks quand des fichiers sont créés ou supprimés dans un compte connecté. Chaque notification est signée dans le header X-Drime-Signature.

#Webhooks Drime Sign

Dans Paramètres > Développeurs > Webhooks (Notifications HTTP pour les événements Drime Sign.), cliquez sur Ajouter un webhook pour que votre serveur soit prévenu, par exemple quand :

• un document est envoyé, terminé ou refusé ;

• un signataire consulte, signe ou refuse ;

• un modèle est créé.

Chaque notification est signée avec un secret (X-Drime-Signature, HMAC SHA-256). Une notification en échec est renvoyée jusqu'à 10 fois sur environ 34 heures. Vous pouvez Envoyer un test, Régénérer le secret et consulter les Livraisons.

#Intégrer un formulaire de signature à votre site

Dans Paramètres > Développeurs > Intégration, vous pouvez permettre aux visiteurs de signer des documents sans quitter votre site, avec le widget <drime-sign-form>. Ajoutez vos domaines dans Domaines autorisés : sans aucun domaine, l'intégration est désactivée.

#Étapes suivantes

• Créer un token d'API

• Rclone, Drime CLI et WebDAV