openapi: 3.1.0
info:
  version: 1.0.0
  title: Imaginary town
servers:
  - url: 'https://example.com'
    description: Example server
paths:
  /buildings:
    get:
      summary: All buildings
      operationId: buildingsList
      responses:
        '200':
          description: Return all known buildings
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Building'
  '/buildings/{buildingId}':
    get:
      summary: Specific building
      operationId: buildingById
      parameters:
        - name: buildingId
          in: path
          required: true
          description: Which building to return
          schema:
            type: string
      responses:
        '200':
          description: Return a building
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Building'
  /locations:
    get:
      summary: All locations
      operationId: locationList
      responses:
        '200':
          description: Returns all locations
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    location_id:
                      type: integer
                      example: 44
                    name:
                      type: string
                      example: North Village
components:
  schemas:
    Building:
      type: object
      properties:
        building:
          type: string
        location_id:
          type: integer
          example: 44