add /journeys endpoint

standard-covoiturage_openapi.yaml

@@ -176,6 +176,43 @@ paths:
         500:
           $ref: '#/components/responses/InternalServerError'
 
+  /journeys:
+    get:
+      tags:
+      - List
+      summary: Get journeys by their ids.
+      description: Route used to retrieve journeys using their identifiers.
+      operationId: getJourneys
+      parameters:
+        - in: query
+          name: ids[]
+          required: true
+          explode: true
+          schema:
+            type: array
+            items:
+              type: string
+              minLength: 1
+              maxLength: 255
+      responses:
+        200:
+          description: Ok. Request processed successfully.
+          content:
+            application/json:
+              schema:
+                title: Journey
+                oneOf:
+                - $ref: '#/components/schemas/DriverJourney'
+                - $ref: '#/components/schemas/PassengerJourney'
+        400:
+          $ref: '#/components/responses/BadRequest'
+        401:
+          $ref: '#/components/responses/Unauthorized'
+        429:
+          $ref: '#/components/responses/TooManyRequests'
+        500:
+          $ref: '#/components/responses/InternalServerError'
+
   /status:
     get:
       tags:
@@ -480,7 +517,7 @@ components:
           minLength: 1
           maxLength: 255
           description: Id of next Journey in the return direction.
-          
+
 
     DriverJourney:
       type: object