Je možné pomocou OpenAPI opísať odosielanie viacerých súborov?

Áno, v OpenAPI je možné opísať odosielanie viacerých súborov. Na to sa zvyčajne používa typ multipart/form-data s poľom súborov. V špecifikácii OpenAPI 3.0 sa to robí cez parameter typu array s prvkami typu string a formátom binary.

Príklad opisu parametra pre viac súborov:

requestBody:
  content:
    multipart/form-data:
      schema:
        type: object
        properties:
          files:
            type: array
            items:
              type: string
              format: binary

Tento prístup umožňuje klientovi odoslať viacero súborov v jednom požiadavku.