Helpcentrum

API-keys aanmaken

API-keys aanmaken met de juiste scope, gebruiken in integraties en veilig intrekken.

API-keys aanmaken

Met API-toegang (vanaf Business) koppel je PureDigi aan externe systemen — denk aan een boekhoudpakket, een voorraadsysteem of een eigen script. Maak per integratie een aparte key met een eigen scope.

Een key aanmaken

  • Ga naar Settings → API → Keys.
  • Klik op Nieuwe key en geef een herkenbare naam (bv. "Boekhouding" of "Voorraad-sync").
  • Kies de scope: `read`, `write` of specifieke modules. Geef niet meer rechten dan nodig.
  • Kopieer de key direct — je ziet hem maar één keer. Bewaar hem in een wachtwoordmanager of de secrets-store van je integratie.
  • De key gebruiken

    Stuur de key mee als bearer-token in de `Authorization`-header van je verzoeken:

    Authorization: Bearer pd_live_xxxxxxxxxxxxxxxx

    Een key intrekken

    Vermoed je dat een key gelekt is, of stop je met een integratie? Klik op Revoke in het overzicht. De key werkt dan direct niet meer; de bijbehorende integratie krijgt een 401-fout tot je een nieuwe key configureert.

    Veiligheidstips

    • Gebruik één key per integratie, zodat je er één kunt intrekken zonder de rest te raken.
    • Zet keys nooit in publieke code of front-end JavaScript.
    • Rouleer keys periodiek: maak een nieuwe aan, schakel je integratie om en revoke de oude.
    Terug naar Klanten & rollen

    Vraag overgebleven? Stuur ons een mail of bel 085 250 2647 (werkdagen 09–17).