Robaws API

Authentication

1. Get Authorization code

Required parameters
- client_id
- redirect_uri
- scope

You can find the available scopes in the Robaws documentation (OAuth endpoints).

Steps

1. Construct the get code URL with the required parameters
2. Paste this URL into your browser
3. Log in with your Robaws account
   
4. Grant access to the application
   

5. You will receive an authorization code in the URL

6. Get Access & Refresh Token from Code When retrieved the Code from the URL
   Important This only needs to be done once in the beginning of the API authentication setup!

   1. Insert the Code from the URL into the code variable
   2. Add the client secret from the Robaws Application (needs to be stored in 1Password)
   3. Add the client ID from the Robaws Application (needs to be stored in 1Password)
   4. Send the POST request
      
   5. Take the refresh_token from the response and store it safely in the Azure Key Vault with the following naming convention robaws-refresh-token this is the most important part since this refresh token widll be used by the Azure Function to get an access token for authentication.
   6. Copy the access token as well but don't store it in Azure.
7. Get Access from Refresh Token
   1. If one already has a refresh token a new access token can be retrieved with it. User the POST method in Postman called access from refresh to retrieve a new access token
8. Get Data
   1. Retrieve an access token (usually from the refresh token option)
   2. Copy the new access_token value from the response
   3. Insert the new access token in the access_token collection variable in the header of the desired GET request and press send to check if the response works and data is being returned