kiolyn-api-specs/specs/station.yaml

Update

/station/{storeid}:
  get:
    tags:
    - station
    description: Return all the stations belong to given store
    operationId: listStations
    security:
    - bearerAuth: []
    parameters:
    - $ref#storeid: './parameters/storeid.yaml'
    responses:
      $ref#4xx: './responses/4xx.yaml'
      200:
        description: list of station
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Station'
  post:
    tags:
    - station
    description: Update/Create station
    operationId: saveStation
    security:
    - bearerAuth: []
    parameters:
    - $ref#storeid: './parameters/storeid.yaml'
    requestBody:
      required: true
      content:
        application/json: 
          schema: 
            $ref: '#/components/schemas/Station'
    responses:
      $ref#4xx: './responses/4xx.yaml'
      $ref#upsert: './responses/20x-upsert.yaml'

/station/{storeid}/{id}:
  get:
    tags:
    - station
    description: Return the station with given id
    operationId: loadStation
    security:
    - bearerAuth: []
    parameters:
    - $ref#storeid: './parameters/storeid.yaml'
    - $ref#id: './parameters/objectid.yaml'
    responses:
      $ref#4xx: './responses/4xx.yaml'
      200:
        description: station detail
        content:
          application/json:
            schema:
              type: object
              properties: 
                value:
                  $ref: '#/components/schemas/Station'
  delete:
    tags:
    - station
    description: Delete a station with given id
    operationId: deleteStation
    security:
    - bearerAuth: []
    parameters:
    - $ref#storeid: './parameters/storeid.yaml'
    - $ref#id: './parameters/objectid.yaml'
    responses:
      $ref#4xx: './responses/4xx.yaml'
      $ref#204: './responses/204.yaml'

/mainstation/{storeid}:
  get:
    tags:
    - station
    description: Return the main station of the store
    operationId: loadMainStation
    security:
    - bearerAuth: []
    parameters:
    - $ref#storeid: './parameters/storeid.yaml'
    responses:
      $ref#4xx: './responses/4xx.yaml'
      200:
        description: station detail
        content:
          application/json:
            schema:
              type: object
              properties: 
                value:
                  $ref: '#/components/schemas/Station'