openapi: "3.0.3"

info:
  version: 1.0.0
  title: ows-artwork spec

servers:
  - url: https://qa-ows-artwork.theorchard.io
    description: QA Server

paths:
  /hello/:
    get:
      summary: Check the health of the application.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: "OK"
  /coverart:
    get:
      summary: Retrieve coverart.
      parameters:
        - in: query
          name: productIds
          description: One or more Product IDs
          required: true
          style: form
          explode: false
          schema:
            type: array
            items:
              type: integer
          examples:
            oneId:
              summary: Example of a single ID
              value: [5]   # ?ids=5
            multipleIds:
              summary: Example of multiple IDs
              value: [1, 5, 7]  # ?ids=1,5,7
        - in: query
          name: imageFormat
          required: true
          schema:
            type: string
            enum: [cover, xlcover]
      responses:
        200:
          description: 200 OK
          content:
            application/json:
              schema:
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        apiVersion:
                          type: string
                        imageFormat:
                          type: string
                        productId:
                          type: string
                        url:
                          type: string