home.md

@@ -23,14 +23,17 @@ https://portal.robotsindeklas.nl/API/v1
 Please note that you should use the POST method for your request unless indicated otherwise.
 
 ### 2.3 Parameters
-The parameters for the requests should be defined in the body of the request in JSON format.
+To send the required parameters for your request, please put them in the body of the request in JSON format.
 
 ### 2.4 Requesting token
+To access the public API, we first have to authorize ourselves by getting a valid token to perform the desired actions. A token can be requested by making a POST request to:
 
 ```
 https://portal.robotsindeklas.nl/API/v1/auth/getToken
 ```
 
+In the body of the request, enter the following details:
+
 ```
 {
     "username": "USERNAME",
@@ -40,6 +43,7 @@ https://portal.robotsindeklas.nl/API/v1/auth/getToken
 ```
 
 Example:
+
 ```
 {
     "username": "Pietje",
@@ -48,8 +52,10 @@ Example:
 }
 ```
 
+If a valid combination of username, password, and the domain is given, a **bearer token** is returned which can be used to authorize the public API requests. 
 
 ### 2.5 Items
+The logic of the API is divided into a number of items.
 
 - app
 - folder