Bouwsoft API Authentication

API

Bouwsoft has an REST API.

Authentication

The documentation is here:

1. support.bouwsoft.be/manual/api/

2. support.bouwsoft.be/manual/api/?page=connection

In summary, you need to perform these steps:

1. log into our Visma developer account using our pwr@powerpartners.pro account

2. create an app, and call it according to the client code, e.g. #tb

3. in postman, call https://charon.bouwsoft.be/api/v1/Authorize/RefreshToken

   1. provide the app key
   2. do not provide a requestId
   3. do not provide a redirectUri
      you will receive a URL and a requestId
      
4. in a browser
   1. paste the URL into a browser
   2. log in with your bouwsoft user and password
      
   3. give the device any name (e.g. browser)
   4. grant access
      
5. in in postman, call https://charon.bouwsoft.be/api/v1/Authorize/RefreshToken again, but this time
   1. same: provide the app key
   2. new: provide the requestId from the previous step
   3. same: do not provide a redirectUri
6. you will receive
   1. a ClientNr
   2. a RefreshToken
   3. a ServerName
   4. an AccessToken
      
7. With that information, you can either
   1. call the API (with the AccessToken)
   2. get a new AccessToken (with the RefreshToken)
      
      in short, you can store the ClientNr, the RefreshToken and the ServerName either in postman or in the KeyVault in order to access the API.
      

References