feat: API docs for service api (#24425)

Signed-off-by: -LAN- <laipz8200@outlook.com>
2025-08-25 09:26:54 +08:00
parent 846b6bd14e
commit b7466f8b65
31 changed files with 1724 additions and 627 deletions
--- a/api/fields/member_fields.py
+++ b/api/fields/member_fields.py
@@ -1,8 +1,17 @@
-from flask_restx import fields
+from flask_restx import Api, Namespace, fields

 from libs.helper import AvatarUrlField, TimestampField

-simple_account_fields = {"id": fields.String, "name": fields.String, "email": fields.String}
+simple_account_fields = {
+    "id": fields.String,
+    "name": fields.String,
+    "email": fields.String,
+}
+
+
+def build_simple_account_model(api_or_ns: Api | Namespace):
+    return api_or_ns.model("SimpleAccount", simple_account_fields)
+

 account_fields = {
    "id": fields.String,