Կարո՞ղ եք 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

Այս մոտեցումը թույլ է տալիս հաճախորդին ուղարկել մի քանի ֆայլ մեկ հարցում։