openapi: 3.0.0
info:
  title: Media API
  description: >-
    Hypermedia API used to demonstrate several new constructs in the OpenAPI
    set.
  version: 1.0.0
  termsOfService: none
paths:
  '/hypermedia/{title}':
    get:
      summary: Get hypermedia information about a specific title
      description: >-
        get information about a media, including metadata, reviews, images,
        editor's cut and trailers, etc.
      operationId: getHypermedia
      parameters:
        - name: title
          in: path
          required: true
          description: the unique title of the media.
          schema:
            type: string
      responses:
        '200':
          description: the media title has been found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Hypermedia'
              example: null
components:
  schemas:
    MediaMetadata:
      title: mediaMetadata
      type: object
      properties:
        name:
          description: None provided.
          type: string
    Images:
      title: images
      type: array
      items:
        type: string
    Video:
      title: video
      type: array
      items:
        type: string
        format: binary
    Reviews:
      title: reviews
      type: array
      items:
        type: string
    Tags:
      title: tags
      type: array
      items:
        type: string
    Hypermedia:
      title: hypermedia
      type: object
      allOf:
        - $ref: '#/components/schemas/MediaMetadata'
        - $ref: '#/components/schemas/Images'
        - $ref: '#/components/schemas/Video'
        - $ref: '#/components/schemas/Tags'
        - $ref: '#/components/schemas/Reviews'