Modifies director API specs. Implementation expected in ITISFoundation#363

Author: Pedro Crespo

api/specs/director/v0/openapi.yaml

@@ -72,7 +72,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '../../shared/schemas/services.yaml#/components/schemas/ServicesEnveloped'                
+                $ref: '../../shared/schemas/services.yaml#/components/schemas/ServicesEnveloped'
         "401":
           description: Unauthorized access
           content:
@@ -102,7 +102,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '../../shared/schemas/services.yaml#/components/schemas/ServicesEnveloped'                
+                $ref: '../../shared/schemas/services.yaml#/components/schemas/ServicesEnveloped'
         "401":
           description: Unauthorized access
           content:
@@ -129,7 +129,7 @@ paths:
       summary: Starts an interactive service in the oSparc platform and returns its entrypoint
       description: Starts an interactive service in the oSparc platform and returns its entrypoint
       operationId: running_interactive_services_post
-      parameters:         
+      parameters:
         - $ref: '#/components/parameters/UserId'
         - $ref: '#/components/parameters/ServiceKey'
         - $ref: '#/components/parameters/ServiceVersion'
@@ -182,12 +182,12 @@ paths:
       parameters:
         - $ref: '#/components/parameters/ServiceUuid'
       responses:
-        "204":
-          description: OK service exists and runs
+        "200":
+          description: "Services exists and runs. Returns enpoint of running service"
           content:
             application/json:
               schema:
-                $ref: '../../shared/schemas/response204.yaml#/components/schemas/Response204Enveloped'
+                $ref: '../../shared/schemas/running_service.yaml#/components/schemas/RunningServiceEnveloped'
         "400":
           description: Malformed function call, missing field
           content:

api/specs/shared/schemas/running_service.yaml

@@ -10,12 +10,14 @@ components:
         error:
           nullable: true
           default: null
-          
+
     RunningServiceType:
       type: object
       required:
         - published_port
         - service_uuid
+        - service_key
+        - service_version
       properties:
         published_port:
           description: The ports where the service provides its interface
@@ -32,3 +34,18 @@ components:
           type: string
           format: UUID
           example: 123e4567-e89b-12d3-a456-426655440000
+        service_key:
+          type: string
+          description: distinctive name for the node based on the docker registry path
+          pattern: '^(simcore)/(services)/(comp|dynamic)(/[^\s/]+)+$'
+          example:
+            - simcore/services/comp/itis/sleeper
+            - simcore/services/dynamic/3dviewer
+        service_version:
+          type: string
+          description: semantic version number
+          pattern: >-
+            ^(0|[1-9]\d*)(\.(0|[1-9]\d*)){2}(-(0|[1-9]\d*|\d*[-a-zA-Z][-\da-zA-Z]*)(\.(0|[1-9]\d*|\d*[-a-zA-Z][-\da-zA-Z]*))*)?(\+[-\da-zA-Z]+(\.[-\da-zA-Z-]+)*)?$
+          example:
+            - 1.0.0
+            - 0.0.1