我是否需要一个专用的请求对象和一个Swagger中的响应对象?

我是否需要一个专用的请求对象和一个Swagger中的响应对象?,swagger,swagger-2.0,Swagger,Swagger 2.0,例如,创建学生对象 如果我创建一个,用户不必输入学生id,因为它是在后端生成的 如果我返回一个id为的学生,它返回的属性将多于用于创建的原始学生对象的属性。可能它包含了学生注册的科目 我是否应该根据需要或目的创建一个专用的请求和响应对象?我建议只为请求和响应声明一个对象“student”,并将id属性标记为可选属性,然后利用供应商扩展来记录特定场景中需要的属性(请求、响应等)@wing328您的意思是会有另一份文件来说明不同的场景吗?或者可以将其放在swagger io中?我的意思是在相同的sw

例如,创建学生对象

如果我创建一个,用户不必输入学生id,因为它是在后端生成的

如果我返回一个id为的学生,它返回的属性将多于用于创建的原始学生对象的属性。可能它包含了学生注册的科目


我是否应该根据需要或目的创建一个专用的请求和响应对象?

我建议只为请求和响应声明一个对象“student”,并将
id
属性标记为可选属性,然后利用供应商扩展来记录特定场景中需要的属性(请求、响应等)@wing328您的意思是会有另一份文件来说明不同的场景吗?或者可以将其放在swagger io中?我的意思是在相同的swagger规范中记录它,并使用供应商扩展来描述附加信息。有关更多信息,请参阅和。