Access token aanvragen

1. Een api token is verplicht om een Access token te kunnen aanvragen. De gebruiker kan deze zelf aanvragen onder “Integraties” -> “Ontwikkelaar” -> “API Sleutels”. Meer info kun je vinden in de video over “API Sleutel aanvragen”.
2. Via een HTTP GET call naar https://authentication.doffice.app/client/api met de API token als Basic authorization header bestaand uit PUBLICKEY:SECRETKEY in base64 formaat, zal een response hebben met een token element.
3. Het token object bevat de waarde key die de access token bevat. Deze key is enkel geldig op het IP adres die gebruikt was tijdens de aanvraag en heeft een beperkte levensduur.
4. Via de url https://api.doffice.app en een GraphQL client naar keuze is het mogelijk om de algemene API van D’Office te gebruiken. D’Office bied een vooraf ingestelde online client aan op de url https://api.doffice.app/documentation.

Opmerkingen: 

• Door de IP restricities in combinatie met de beperkte levensduur van de access token, raden we niet aan deze op te slaan in een database. De volledige “Developer API token” is de enige token die bewaard moet worden. Deze bestaat uit een publiek gedeelte die dient als username en een private gedeelte die geheim moet blijven en dient als wachtwoord.
• We raden altijd aan op het geheime gedeelte ge-encrypeert op te slaan.