Is het mogelijk om het verzenden van meerdere bestanden te beschrijven met OpenAPI?

Ja, in OpenAPI is het mogelijk om het verzenden van meerdere bestanden te beschrijven. Hiervoor wordt meestal het type multipart/form-data gebruikt met een array van bestanden. In de OpenAPI 3.0 specificatie wordt dit gedaan via een parameter van het type array met elementen van het type string en het formaat binary.

Voorbeeld van een parameterbeschrijving voor meerdere bestanden:

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

Deze aanpak stelt de client in staat om meerdere bestanden in één verzoek te verzenden.