openapi: 3.0.0

info:
  title: My API
  version: '0.1'

paths:
  /books/{id}:
    parameters:
      - in: path
        name: id
        description: book ID
        required: true

        schema:
          title: ID
          type: string

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

      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