Este posibil să descrii trimiterea mai multor fișiere cu OpenAPI?

Da, în OpenAPI se poate descrie trimiterea mai multor fișiere. Pentru aceasta, de obicei, se folosește tipul multipart/form-data cu un array de fișiere. În specificația OpenAPI 3.0, acest lucru se face printr-un parametru de tip array cu elemente de tip string și format binary.

Exemplu de descriere a parametrului pentru mai multe fișiere:

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

Această abordare permite clientului să trimită mai multe fișiere într-o singură solicitare.