Оё имкон дорад, ки бо OpenAPI тавсиф кардани фиристодани чанд файл имконпазир бошад?

Бале, дар OpenAPI мумкин аст, ки тасвир карда шавад, ки чӣ гуна метавон чанд файл фиристод. Барои ин одатан аз навъи multipart/form-data бо массиви файлҳо истифода мешавад. Дар спецификацияи OpenAPI 3.0 ин тавассути параметри навъи array бо унсурҳои навъи string ва формати binary иҷро мешавад.

Масалан, барои тавсифи параметри чанд файл:

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

Ин усул имкон медиҳад, ки муштарӣ дар як дархост чанд файл фиристад.