Peut-on décrire l'envoi de plusieurs fichiers avec OpenAPI?

Oui, dans OpenAPI, il est possible de décrire l'envoi de plusieurs fichiers. Cela se fait généralement en utilisant le type multipart/form-data avec un tableau de fichiers. Dans la spécification OpenAPI 3.0, cela se fait via un paramètre de type array avec des éléments de type string et le format binary.

Exemple de description du paramètre pour plusieurs fichiers:

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

Cette approche permet au client d'envoyer plusieurs fichiers dans une seule requête.