Swagger 如何创建接受请求中的对象和文件的OpenAPI端点？

我的OpenAPI规范中有以下API端点：

'/email':
  post:
    tags:
      - email-service
    summary: Email Service
    operationId: sendEmail
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/EmailRequestDTO'

我想在请求中添加发送附件的功能。我一直在阅读有关OpenAPI和

multipart/form data

，

multipart/mixed

，以及

multipart/related

，但我并没有对它感到困惑。我甚至不确定OpenAPI是否支持

multipart/related

---

有人能告诉我，我的OpenAPI规范文件需要什么样的外观才能向上述API添加附件吗？

这是否回答了您的问题--