Eine App entwickeln oder Webhooks einrichten

Um die Drime-API mit Ihrem eigenen Konto zu nutzen, genügt ein persönliches Token: siehe Ein API-Token erstellen. Um eine App zu entwickeln, die andere Drime-Nutzer mit ihrem Konto verbinden, erstellen Sie eine OAuth-Anwendung: Ihre Nutzer genehmigen sie bei Drime, und die App bekommt deren Passwort nie zu sehen.

#Eine OAuth-Anwendung erstellen

Jeder angemeldete Nutzer kann im Entwicklerportal Anwendungen erstellen, über Meine Anwendungen und dann Anwendung erstellen.

Zuerst wählen Sie, was Sie entwickeln:

Danach wählen Sie, was die Anwendung braucht: Ein eigener Ordner (sie sieht immer nur einen einzigen Ordner, der im Drive erstellt wird) oder Das gesamte Drive.

Gut zu wissen:

• Sie können bis zu 25 Anwendungen erstellen.

• Eine neue Anwendung funktioniert für bis zu 25 Nutzer. Um sie für mehr Personen zu öffnen, verwenden Sie Für alle öffnen und dann Zur Prüfung senden: Drime antwortet innerhalb von 24 Stunden.

• Zugriffstokens sind 1 Stunde gültig, Aktualisierungstokens 90 Tage.

• Anwendungen von Drittanbietern können nie auf einen Vault zugreifen.

Anwendungen vom Typ Eine Website oder ein Server können außerdem Webhooks empfangen, wenn in einem verbundenen Konto Dateien erstellt oder gelöscht werden. Jede Benachrichtigung ist im Header X-Drime-Signature signiert.

#Webhooks für Drime Sign

Klicken Sie unter Einstellungen > Entwickler > Webhooks (HTTP-Benachrichtigungen für Drime-Sign-Ereignisse.) auf Webhook hinzufügen, damit Ihr Server zum Beispiel benachrichtigt wird, wenn:

• ein Dokument gesendet, abgeschlossen oder abgelehnt wird;

• ein Unterzeichner ein Dokument ansieht, unterschreibt oder ablehnt;

• eine Vorlage erstellt wird.

Jede Benachrichtigung wird mit einem Secret signiert (X-Drime-Signature, HMAC SHA-256). Eine fehlgeschlagene Benachrichtigung wird bis zu 10-mal erneut gesendet, verteilt über etwa 34 Stunden. Sie können Test senden und Schlüssel neu generieren verwenden und die Zustellungen prüfen.

#Ein Signaturformular auf Ihrer Website einbetten

Unter Einstellungen > Entwickler > Einbetten können Sie Besuchern mit dem Widget <drime-sign-form> ermöglichen, Dokumente zu unterschreiben, ohne Ihre Website zu verlassen. Tragen Sie Ihre Domains unter Erlaubte Domains ein: Ohne Domain ist das Einbetten deaktiviert.

#Nächste Schritte

• Ein API-Token erstellen

• Rclone, Drime CLI und WebDAV