Μπορείτε να περιγράψετε την αποστολή πολλαπλών αρχείων με το 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

Αυτή η προσέγγιση επιτρέπει στον πελάτη να στέλνει πολλά αρχεία σε ένα μόνο αίτημα.