[Improvement][swagger] Now the interface document returns only the generic template

[fuchanghai]

Search before asking

• I had searched in the issues and found no similar feature requirement.

Description

If the developer is a front end, he wants to see the data structure in 'data'

If the response attribute of the annotation @ApiOperation is used, the interface document can see the data structure of data, but cannot see the general return template. Can you give some advice? Need a discussion tag?
@SbloodyS @EricGao888

Are you willing to submit a PR?

• Yes I am willing to submit a PR!

Code of Conduct

• I agree to follow this project's Code of Conduct

[github-actions]

Search before asking

• I had searched in the issues and found no similar feature requirement.

Description

If the developer is a front end, he wants to see the data structure in 'data'

If the response attribute of the annotation @ApiOperation is used, the interface document can see the data structure of data, but cannot see the general return template. Can you give some advice? Need a discussion tag?
@SbloodyS @EricGao888

Are you willing to submit a PR?

• Yes I am willing to submit a PR!

Code of Conduct

• I agree to follow this project's Code of Conduct

[github-actions]

Thank you for your feedback, we have received your issue, Please wait patiently for a reply.

• In order for us to understand your request as soon as possible, please provide detailed information、version or pictures.
• If you haven't received a reply for a long time, you can join our slack and send your question to channel #troubleshooting

[SbloodyS]

This is one of the reasons why we refactor the API in #10257. Currently, you can debug by opening F12 in the page to view the format of specific parameters.

[fuchanghai]

@SbloodyS Although after your modification, I can only see the unified return structure。

{
	"code": 0,
	"data": {},
	"failed": true,
	"msg": "",
	"success": true
}

i mean as a ui,even if some default values ​​of f12 are null, the front end cannot judge the type of the parameter, nor does it know the meaning of each attribute of the object in 'data'.so why i open this issue

[SbloodyS]

You can find the data structure through swagger ui after refactor to v2 api. For more detail you can take a look at #10301.

[fuchanghai]

@SbloodyS you are so smart,thx