Implementing AirportDto, CityDto, GPSLocationDto, CountryDto

openapi.yaml

@@ -69,7 +69,6 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/ErrorMessage'
-
   /api/stewards/{id}:
     get:
       tags:
@@ -116,6 +115,36 @@ paths:
                 $ref: '#/components/schemas/ErrorMessage'
         '401':
           description: unauthorized
+    put:
+      tags:
+        - Steward
+      summary: Update steward by id
+      operationId: updateSteward
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: integer
+            format: int64
+      description: |
+        Receives data both in request body and as URL parameter and updates a steward by id.
+        Returns the updated steward as response.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/StewardDto'
+        required: true
+      responses:
+        "201":
+          $ref: '#/components/responses/SingleStewardDtoResponse'
+        "400":
+          description: input data were not correct
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorMessage'
   /api/stewards/paged:
     get:
       tags:
@@ -315,7 +344,7 @@ components:
         - $ref: '#/components/schemas/DomainEntity'
       type: object
       title: airplane
-      description: represents airplane
+      description: represents an airplane
       required:
         - id
         - name
@@ -395,6 +424,91 @@ components:
           $ref: '#/components/schemas/PageableObject'
         empty:
           type: boolean
+    CountryDto:
+      allOf:
+        - $ref: '#/components/schemas/DomainEntity'
+      type: object
+      title: country
+      description: represents a country
+      required:
+        - id
+        - name
+      properties:
+        name:
+          type: string
+          description: country name
+          example: Canada, France, ...
+    CityDto:
+      allOf:
+        - $ref: '#/components/schemas/DomainEntity'
+      type: object
+      title: city
+      description: represents a city in a country containing airports
+      required:
+        - id
+        - name
+      properties:
+        name:
+          type: string
+          description: city name
+          example: New York, London
+        country:
+          $ref: '#/components/schemas/CountryDto'
+        airports:
+          type: array
+          items:
+            $ref: '#/components/schemas/AirplaneDto'
+    GPSLocationDto:
+      type: object
+      title: GPS location
+      description: represents a GPS location of latitude and longitude
+      required:
+        - latitude
+        - longitude
+      properties:
+        latitude:
+          type: number
+          format: double
+          example: 41.40338
+        longitude:
+          type: number
+          format: double
+          example: 2.17403
+    AirportDto:
+      allOf:
+        - $ref: '#/components/schemas/DomainEntity'
+      type: object
+      title: airport
+      description: represents an airport
+      required:
+        - id
+        - name
+        - code
+        - departingFlights
+        - arrivingFlights
+        - city
+        - location
+      properties:
+        name:
+          type: string
+          description: airport name
+          example: John F. Kennedy International Airport, Charles de Gaulle International Airport, ...
+        code:
+          type: string
+          description: airport code in IATA format
+          example: JFK, CDG, ...
+        departingFlights:
+          type: array
+          items:
+            $ref: '#/components/schemas/FlightDto'
+        arrivingFlights:
+          type: array
+          items:
+            $ref: '#/components/schemas/FlightDto'
+        city:
+          $ref: '#/components/schemas/CityDto'
+        location:
+          $ref: '#/components/schemas/GPSLocationDto'
   responses:
     SingleStewardDtoResponse:
       description: response containing a single steward