📄 API / Bekijken

API / Bekijken

Laatst bijgewerkt: 09-11-2026

Op de pagina API-sleutels zie je welke API-sleutels er zijn, wanneer ze verlopen en of ze nog werken. Je leest hier alleen af. Een sleutel toevoegen, vernieuwen of verwijderen doe je in Bewerken.

In dit artikel leer je:

  1. De pagina API-sleutels openen en kiezen tussen persoonlijke en accountbrede sleutels
  2. Op de kaart van een sleutel aflezen wanneer hij verloopt en of hij nog werkt
  3. Aflezen welk deel van een persoonlijke sleutel niet werkt en wie een accountbrede sleutel heeft aangemaakt
  4. Sleutels die verlopen zijn of binnenkort verlopen terugvinden op het Accountdashboard
  5. Weten wanneer je naar Bewerken moet
💡

Bekijken / Bewerken toggle staat bovenaan elke pagina. Klik om te wisselen tussen Bekijken en Bewerken. Deze handleiding beschrijft de Bekijken-weergave (editor) van de API-pagina. 

Kernconcepten 

Voordat je aan de slag gaat, is het handig om de volgende type objecten te kennen. 

  • API-sleutel — geeft je eigen software toegang tot Spreash®. De sleutel werkt namens jou, met de rechten die je hem geeft, en nooit met meer rechten dan je zelf hebt.

  • Persoonlijke API-sleutel — hoort bij de gebruiker die hem heeft aangemaakt. Elke gebruiker ziet alleen de eigen sleutels. De sleutel werkt niet meer als die gebruiker vertrekt.

  • Accountbrede API-sleutel — hoort bij het account en werkt alleen met zijn eigen rechten. Hij blijft werken als degene die hem heeft ingesteld vertrekt.

  • Client-ID — de naam van een sleutel voor de API. Hij staat op de kaart van de sleutel.

  • Verloopt binnenkort / Verlopen — labels op de kaart van een sleutel. Verloopt binnenkort verschijnt in de laatste 14 dagen voordat de sleutel verloopt.

Video walkthrough

 [Link video volgt.]

Hoe bereik je de API-sleutels?

Open rechtsboven het profielmenu en kies API-sleutels. Staat de schakelaar linksboven op Bewerken, schakel dan terug naar Bekijken.

Profielmenu

Wat zie je op de pagina API-sleutels?

De pagina toont een kaart voor elke sleutel die je mag zien. Heb je nog geen sleutel, dan begin je in API / Bewerken met je eerste sleutel.

  • Persoonlijk — tabblad met je eigen persoonlijke sleutels. Je ziet hier nooit de sleutels van een collega.
  • Accountbreed — tabblad met de accountbrede sleutels van het account.

De tabbladen Persoonlijk en Accountbreed verschijnen als je beide soorten sleutels mag aanmaken.

De kaart van een API-sleutel

Op de kaart van een sleutel lees je af wat de sleutel doet en of hij nog werkt.

  • Naam — de naam waaraan je herkent welke koppeling de sleutel gebruikt.
  • Omschrijving — wat de koppeling doet. 
  • Client-ID — de naam van de sleutel voor de API. Je kunt hem altijd opnieuw kopiëren.
  • Verloopt — wanneer de sleutel verloopt. Elke sleutel verloopt uiterlijk een jaar nadat hij is aangemaakt of zijn geheim voor het laatst is vernieuwd.
  • Verloopt binnenkort — de sleutel verloopt binnen 14 dagen.
  • Verlopen — de sleutel is verlopen. Een verlopen sleutel krijgt geen nieuwe toegangstokens, en de toegangstokens die hij al heeft werken niet meer.
  • Aangemaakt door — alleen bij accountbrede sleutels: wie de sleutel heeft aangemaakt.
  • Rechten van de sleutel — de organisaties, domeinen en modulerechten (lezen of schrijven) waarvoor de sleutel werkt. 
  • Melding bij een persoonlijke sleutel — de kaart meldt welk deel van de sleutel niet werkt als je een recht hebt verloren dat de sleutel had. Zodra je het recht terugkrijgt, werkt dat deel weer.
💡

Je ziet nooit het clientgeheim. Spreash® toont het maar één keer, bij het aanmaken of vernieuwen van een sleutel.

⚠️

Op deze pagina lees je alleen af. Heb je een sleutel nodig, moet een geheim worden vernieuwd of moet een sleutel weg? Schakel dan linksboven naar Bewerken. De stappen staan in API / Bewerken.

Veelvoorkomende situaties 

  • Ik zie API-sleutels niet in het profielmenu.
    Je gebruikersgroep heeft er geen toegang toe. Neem contact op met je accountbeheerder of met Spreash® support. [CONTROLEREN: bepaalt het recht API-toegang of je het menu ziet?]
  • Ik zie het tabblad Accountbreed of Persoonlijk niet.
    De tabbladen verschijnen alleen als je zowel persoonlijke als accountbrede sleutels mag aanmaken. Welke rechten je hebt, zie je bij Gebruikersbeheer. Of neem contact op met je accountbeheerder.
  • Ik zie de sleutel van een collega niet.
    Persoonlijke sleutels zijn alleen voor de gebruiker die ze heeft aangemaakt. Laat je collega zijn eigen sleutel bekijken. Een koppeling die voor iedereen moet blijven werken, hoort in een accountbrede sleutel.
  • Ik zie het clientgeheim niet.
    Spreash® toont het clientgeheim maar één keer, bij het aanmaken of vernieuwen van een sleutel. Ben je het kwijt, schakel dan naar Bewerken en vernieuw het geheim.
  • Er staat Verloopt binnenkort of Verlopen bij een sleutel.
    De sleutel krijgt geen nieuwe toegangstokens meer als hij verlopen is. Schakel linksboven naar Bewerken en vernieuw het geheim. Zet het nieuwe geheim in je koppeling voordat het oude stopt.
  • Een persoonlijke sleutel meldt dat een deel niet werkt.
    Een persoonlijke sleutel doet nooit meer dan jij zelf kunt. Je hebt een recht verloren dat de sleutel had. Krijg je het recht terug, dan werkt dat deel weer.
  • Ik zie geen knoppen om iets toe te voegen of aan te passen.
    Je staat in de modus Bekijken, of je hebt niet het recht om sleutels aan te maken. Klik linksboven op Bewerken. Zie je de knoppen dan nog niet, vraag dan het recht aan bij je accountbeheerder.

Gerelateerde pagina's 

⚠️

Kom je er niet uit? Gebruik de Hulp nodig?-knop rechtsboven in Spreash® om direct een ticket in te sturen vanuit jouw Spreash®-omgeving. 

We helpen je zo snel mogelijk verder.  Laat het ons weten via het feedbackformulier onderaan de pagina. Je kunt ook aangeven wat onduidelijk was of wat je miste.