Vai ar ir iespējams ar OpenAPI aprakstīt vairāku failu sūtīšanu?

Jā, OpenAPI iespējams aprakstīt vairākus failu sūtījumus. Parasti to dara, izmantojot multipart/form-data tipu ar failu masīvu. OpenAPI 3.0 specifikācijā tas tiek darīts ar parametru array ar elementiem string tipā un binary formātā.

Piemērs parametra aprakstam vairākām failiem:

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

Šī pieeja ļauj klientam nosūtīt vairākus failus vienā pieprasījumā.