Kas on võimalik kirjeldada mitme faili saatmist OpenAPI abil?

Jah, OpenAPI võimaldab kirjeldada mitme faili saatmist. Selleks kasutatakse tavaliselt tüüpi multipart/form-data koos faili massiiviga. OpenAPI 3.0 spetsifikatsioonis tehakse seda array tüüpi parameetri kaudu, mille elementideks on string tüüp ja binary formaat.

Näide parameetri kirjelduseks mitme faili jaoks:

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

See lähenemine võimaldab kliendil saata ühe taotlusega mitu faili.