Czy można opisać wysyłanie wielu plików za pomocą OpenAPI?

Tak, w OpenAPI można opisać wysyłanie wielu plików. Zazwyczaj używa się typu multipart/form-data z tablicą plików. W specyfikacji OpenAPI 3.0 jest to realizowane przez parametr typu array z elementami typu string i formatem binary.

Przykład opisu parametru dla wielu plików:

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

Takie podejście pozwala klientowi wysłać wiele plików w jednym żądaniu.