Kann man den Versand mehrerer Dateien mit OpenAPI beschreiben?

Ja, in OpenAPI kann man das Hochladen mehrerer Dateien beschreiben. Dafür wird üblicherweise der Typ multipart/form-data mit einem Array von Dateien verwendet. In der OpenAPI 3.0 Spezifikation erfolgt dies über einen Parameter vom Typ array mit Elementen vom Typ string und dem Format binary.

Beispiel für die Beschreibung eines Parameters für mehrere Dateien:

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

Dieser Ansatz ermöglicht es dem Client, mehrere Dateien in einer einzigen Anfrage zu senden.