openapi: 3.0.0

info:
  title: My API
  version: '0.1'

paths:
  /books/{bookId}/{otherId}:

    get:
      summary: get book details
      description: get details for a book

      parameters:
        - in: path
          name: bookId
          description: book ID
          required: true
  
          schema:
            title: ID
            type: string

        - in: path
          name: otherId

      responses:
        '200':
          description: successfully retrieved book details

          content:
            application/json:
              schema:
                title: book details
                type: object

                required:
                  - author
                  - title

                properties:
                  author:
                    title: book author name
                    type: string

                  title:
                    title: book title
                    type: string
