Thema
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
- Klik links op
Instellingenen dan opAPI. - Klik op
Nieuwe API-token. - Vul een
Naamin, zodat je later weet waarvoor het token is, bijvoorbeeld de naam van de applicatie. - Kies bij
Geldigheidhoe lang het token werkt:Verloopt nooit,Na 30 dagen,Na 90 dagenofNa 1 jaar. - Klik op
Opslaan. - Je ziet het token één keer. Kopieer het met
Kopiërenen bewaar het op een veilige plek. Klik daarna opIk 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
- Klik bij het token op het icoontje
Token hernoemen. - 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.
- Klik bij het token op het verwijder-icoontje.
- Typ de naam van het token om te bevestigen.
- 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.
- Zet de schakelaar bij de integratie aan.
- Klik op
Documentatiebij de integratie voor de uitleg voor degene die de koppeling bouwt.
De integratie gebruikt de API-tokens hierboven. Maak dus eerst een token aan.