Swagger模型是否等于系统中的类

Question

我是Swagger的新手。我能够用swagger记录API，但我不清楚模型。

swagger模型 - 用户

User:
 type: object
 properties:
   uuid:
     type: string
   name:
     type: string
   role:
     type: string
   author:
     $ref: '#/definitions/User'

数据库中的用户类

这里，结构是一样的。

但是，如果我们想通过API发送用户的一些额外细节（例如： - userEdited：boolean），我们可能需要大摇大摆地改变用户模型。我对么？如果不是如何正确处理这种情况？