Een app bouwen of webhooks instellen

Wil je de Drime-API met je eigen account gebruiken, dan is een persoonlijk token genoeg: zie Een API-token maken. Wil je een app bouwen die andere Drime-gebruikers aan hun account koppelen, maak dan een OAuth-applicatie: je gebruikers keuren die goed bij Drime, en de app ziet nooit hun wachtwoord.

#Een OAuth-applicatie maken

Elke ingelogde gebruiker kan applicaties maken in het ontwikkelaarsportaal, via Mijn applicaties en daarna Applicatie maken.

Eerst kies je wat je bouwt:

Daarna kies je wat de applicatie nodig heeft: Een eigen map (ze ziet altijd maar één map, die in de Drive wordt aangemaakt) of De hele Drive.

Goed om te weten:

• Je kunt maximaal 25 applicaties maken.

• Een nieuwe applicatie werkt voor maximaal 25 gebruikers. Wil je haar voor meer mensen openstellen, gebruik dan Voor iedereen openstellen en daarna Ter beoordeling versturen: Drime reageert binnen 24 uur.

• Toegangstokens zijn 1 uur geldig, vernieuwingstokens 90 dagen.

• Applicaties van derden hebben nooit toegang tot een Vault.

Applicaties van het type Een website of een server kunnen ook webhooks ontvangen wanneer er in een gekoppeld account bestanden worden aangemaakt of verwijderd. Elke melding wordt ondertekend in de header X-Drime-Signature.

#Webhooks voor Drime Sign

Klik in Instellingen > Ontwikkelaars > Webhooks (HTTP-meldingen voor Drime Sign-events.) op Webhook toevoegen om je server een melding te laten krijgen wanneer bijvoorbeeld:

• een document wordt verzonden, voltooid of geweigerd;

• een ondertekenaar een document bekijkt, ondertekent of weigert;

• een sjabloon wordt aangemaakt.

Elke melding wordt ondertekend met een secret (X-Drime-Signature, HMAC SHA-256). Een mislukte melding wordt tot 10 keer opnieuw verstuurd, verspreid over ongeveer 34 uur. Je kunt Test versturen en Geheim vernieuwen gebruiken en de Bezorgingen bekijken.

#Een ondertekeningsformulier insluiten op je website

In Instellingen > Ontwikkelaars > Insluiten kun je bezoekers met de widget <drime-sign-form> documenten laten ondertekenen zonder dat ze je website verlaten. Voeg je domeinen toe bij Toegestane domeinen: zonder domein is insluiten uitgeschakeld.

#Volgende stappen

• Een API-token maken

• Rclone, Drime CLI en WebDAV