შეგიძლიათ 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

ეს მიდგომა საშუალებას აძლევს მომხმარებელს ერთ მოთხოვნაში რამდენიმე ფაილის გაგზავნას.