Een API-token maken

Met een API-token krijgt een script of een tool, zoals rclone, toegang tot je Drime-account zonder je wachtwoord. Je kiest wat elk token mag doen, en je kunt het op elk moment intrekken.

Persoonlijke tokens zijn bedoeld voor je eigen scripts, back-ups en tools, die met je eigen account werken. Een app die andere Drime-gebruikers aan hun account koppelen, gebruikt in plaats daarvan OAuth en mag nooit om hun wachtwoord vragen: zie de documentatie van de Drime-API.

#Een token maken

1. Klik rechtsboven op je avatar en daarna op Instellingen.

2. Klik op Ontwikkelaars.

3. Klik bij API-toegangstokens op Token maken.

   

4. Geef het token bij Tokennaam een naam die je herkent.

   Gebruik de naam van de tool of de computer die het gebruikt, bijvoorbeeld “rclone op mijn NAS”. De naam moet 3 tot 100 tekens lang zijn.

5. Kies onder Rechten wat het token mag doen.

   • Alles: volledige toegang tot alle resources.

   • Alleen-lezen: alleen leestoegang tot alle resources.

   • Beperkt: alleen toegang tot de resources die je kiest, elk ingesteld op Geen toegang, Gelezen of Schrijven.

   Zie De juiste rechten kiezen.

   

6. Klik op Aanmaken.

7. Klik op Kopiëren om het token te kopiëren en daarna op Klaar.

   Zodra het token op je klembord staat, toont de knop Gekopieerd!.

   

Het token verschijnt daarna bij API-toegangstokens en werkt meteen. Het verloopt niet: het blijft werken tot je het verwijdert.

#De juiste rechten kiezen

Geef een token alleen wat het nodig heeft.

Bij een token met Beperkt kun je deze resources instellen: Bestanden (inclusief versies en prullenbak), Mappen, Delen, Werkruimtes, Vault, Ondertekenen, Whiteboards, Bestandsverzoeken, Verzenden & volgen, Contacten, Tags en Statistieken. Statistieken (het opslaggebruik) kan alleen worden gelezen, dus daar kies je tussen Geen toegang en Toegang. Houd de muisaanwijzer boven het help-icoon naast een resource om te zien wat die omvat.

Alleen een token met Alles heeft toegang tot je account-, beveiligings- en factureringsinstellingen. Tokens met Alleen-lezen of Beperkt hebben die toegang nooit.

De rechten van een token kun je na het aanmaken niet meer wijzigen. Wil je ze aanpassen, maak dan een nieuw token met de juiste rechten, werk je tool bij en verwijder daarna het oude token.

#Het token gebruiken

Stuur het token mee in de Authorization-header van elk verzoek:

Authorization: Bearer YOUR_ACCESS_TOKEN

De link Documentatie naast API-toegangstokens opent de documentatie van de Drime-API. Hoe je een token met rclone gebruikt, lees je in Rclone, Drime CLI en WebDAV.

#Je tokens bekijken en verwijderen

API-toegangstokens toont de tokens die je zelf hebt gemaakt en de tokens die de Drime-apps voor zichzelf aanmaken: Drime Desktop, Drime Mobile en de browserextensie. Elke rij toont:

• de naam van het token, of de app en het platform, bijvoorbeeld Desktop-app · Windows;

• de rechten, bijvoorbeeld Volledige toegang;

• wanneer het voor het laatst is gebruikt, of Nooit gebruikt.

Heb je nog geen tokens, dan toont het onderdeel Je hebt nog geen persoonlijke toegangstokens.

Zo trek je een token in:

1. Klik aan het eind van de rij op Token verwijderen (het prullenbakicoon).

   

2. Klik op Verwijderen om te bevestigen.

   Het venster waarschuwt: Dit token wordt onmiddellijk en definitief verwijderd. Eenmaal verwijderd kan het niet meer worden gebruikt voor API-verzoeken. Daarna verschijnt Token verwijderd, en elke tool die dat token gebruikt, werkt meteen niet meer.

Je kunt de Drime-apps ook uitloggen via Je sessies en apparaten bekijken en uitloggen.

#Als het niet werkt

#Volgende stappen

• Rclone, Drime CLI en WebDAV

• Je sessies en apparaten bekijken en uitloggen