È possibile descrivere l'invio di più file con OpenAPI?

Sì, in OpenAPI è possibile descrivere l'invio di più file. Per farlo, si utilizza generalmente il tipo multipart/form-data con un array di file. Nella specifica OpenAPI 3.0, ciò si fa tramite un parametro di tipo array con elementi di tipo string e formato binary.

Esempio di descrizione del parametro per più file:

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

Questo approccio permette al client di inviare più file in una singola richiesta.