API doc: started documentation using OPENAPI 3.0.1

doc/api/Makefile

@@ -6,7 +6,7 @@ index.html: swagger-codegen-cli.jar api.yaml
 	java -jar swagger-codegen-cli.jar generate -i api.yaml -l html2 -o ./
 
 swagger-codegen-cli.jar:
-	wget http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.4/swagger-codegen-cli-2.4.4.jar -O swagger-codegen-cli.jar
+	wget http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/3.0.0-rc1/swagger-codegen-cli-3.0.0-rc1.jar -O swagger-codegen-cli.jar
 
 clean:
 	rm -rf index.html swagger-codegen-cli.jar

doc/api/api.yaml

@@ -60,6 +60,7 @@ paths:
           content: {}
         500:
           description: Internal server error
+          content: {}
           
           
 components:
@@ -140,9 +141,9 @@ components:
         projects:
           type: array
           items:
-            $ref: '#/components/schemas/Project'
+            type: object
         user:
-          $ref: '#/components/schemas/User'
+          type: object
         startParameters:
           type: object
           properties: {}