updated api doc bundle and annotations

Author: dmitriy

composer.json

@@ -42,7 +42,7 @@
 		"lexik/jwt-authentication-bundle": "^2.8",
 		"mark-gerarts/automapper-plus-bundle": "^1.3",
 		"matthiasnoback/symfony-console-form": "^3.6",
-		"nelmio/api-doc-bundle": "^3.6",
+		"nelmio/api-doc-bundle": "^4.0",
 		"nelmio/cors-bundle": "^2.1",
 		"piwik/device-detector": "^3.12",
 		"ramsey/uuid-doctrine": "^1.6",

composer.lock

@@ -1,18 +1,34 @@
 nelmio_api_doc:
     documentation:
-        schemes: [http, https]
+        servers:
+            - url: http://{domain}
+              variables:
+                  domain:
+                      default: localhost
+              description: API over HTTP
+            - url: https://{domain}
+              variables:
+                  domain:
+                      default: localhost
+              description: API over HTTPS
         info:
             title: Symfony Api
             description: This is an symfony api environment example
             version: 1.0.0
-        securityDefinitions:
-            Bearer:
-                type: apiKey
-                description: 'Value: Bearer {token}'
-                name: Authorization
-                in: header
+        components:
+            securitySchemes:
+                Bearer:
+                    type: http
+                    scheme: bearer
+                    bearerFormat: JWT
+                ApiKey:
+                    type: apiKey
+                    name: Authorization
+                    description: 'Value: ApiKey {token}'
+                    in: header
         security:
             -   Bearer: []
+            -   ApiKey: []
     areas: # to filter documented areas
         path_patterns:
             - ^/api(?!/doc$) # Accepts routes under /api except /api/doc