Skip to content

API-tokens (beta) ​

Met een API-token kan een andere applicatie, bijvoorbeeld een systeem van je kassa, gegevens uit je Akeroh-omgeving halen of aanpassen.

Let op: de API is in beta. De documentatie kan onvolledig of onjuist zijn. Neem contact met ons op als je hulp nodig hebt.

Je ziet API links in het dashboard alleen als de API voor jouw omgeving is ingeschakeld en je abonnement actief is.

Een token aanmaken ​

  1. Klik links op Instellingen en dan op API.
  2. Klik op Nieuwe API-token.
  3. Vul een Naam in, zodat je later weet waarvoor het token is, bijvoorbeeld de naam van de applicatie.
  4. Kies bij Geldigheid hoe lang het token werkt: Verloopt nooit, Na 30 dagen, Na 90 dagen of Na 1 jaar.
  5. Klik op Opslaan.
  6. Je ziet het token één keer. Kopieer het met Kopiëren en bewaar het op een veilige plek. Klik daarna op Ik heb het token opgeslagen.

Tip: kies een geldigheid. Een verlopen token werkt automatisch niet meer. Dat beperkt de schade als een token ooit uitlekt.

Let op: het token wordt maar één keer getoond. Raak je het kwijt, dan maak je een nieuw token aan. Deel een token nooit met iemand die je niet vertrouwt.

Wat kan een token? ​

Een token kan alles wat iemand met de rol admin kan. Ga er dus voorzichtig mee om.

De documentatie ​

Op de pagina API-tokens staat de knop Documentatie. Daar staat welke gegevens je kunt opvragen. Geef die pagina aan degene die de koppeling bouwt.

Je tokens bekijken ​

Je ziet al je actieve tokens met de naam, wie het token heeft aangemaakt en wanneer, wanneer het verloopt en wanneer het voor het laatst is gebruikt. Staat er nooit, dan is het token nog niet gebruikt.

Bij een token kunnen deze labels staan:

  • Verlopen: het token werkt niet meer.
  • Verloopt binnenkort: het token verloopt binnen 14 dagen.
  • Nooit gebruikt: het token is aangemaakt, maar nog niet gebruikt.
  • 90+ dagen ongebruikt: het token is al lang niet gebruikt. Verwijder het als je het niet meer nodig hebt.

Een token hernoemen ​

  1. Klik bij het token op het icoontje Token hernoemen.
  2. Vul de nieuwe naam in en sla op.

Een token verwijderen ​

Gebruik je een token niet meer, of vertrouw je het niet meer? Verwijder het dan.

  1. Klik bij het token op het verwijder-icoontje.
  2. Typ de naam van het token om te bevestigen.
  3. Klik op Ja, token verwijderen.

Het token stopt dan direct met werken. Dat kun je niet ongedaan maken.

Geschiedenis ​

Klik op Geschiedenis om te zien wie tokens heeft aangemaakt, hernoemd of verwijderd. Meer over deze pagina lees je bij Logboek.

Integraties ​

Onderaan de pagina staat Integraties. Hier schakel je een aangepaste koppeling in voor je omgeving, zoals de cadeaubon-service voor het Bork / Domino (Trivec) kassasysteem.

  1. Zet de schakelaar bij de integratie aan.
  2. Klik op Documentatie bij de integratie voor de uitleg voor degene die de koppeling bouwt.

De integratie gebruikt de API-tokens hierboven. Maak dus eerst een token aan.