From 83448657bd3bd5dd11a3c0a862b1428b77475a2b Mon Sep 17 00:00:00 2001
From: aozhiwei <aozhiwei@kingsome.cn>
Date: Tue, 14 May 2024 18:02:52 +0800
Subject: [PATCH] 1

---
 doc/AAGameMail.py | 72 +++++++++++++++++++++++++++++++++++++++++++++++
 doc/_common.py    | 19 +++++++++++++
 2 files changed, 91 insertions(+)
 create mode 100644 doc/AAGameMail.py

diff --git a/doc/AAGameMail.py b/doc/AAGameMail.py
new file mode 100644
index 00000000..00917718
--- /dev/null
+++ b/doc/AAGameMail.py
@@ -0,0 +1,72 @@
+import _common
+
+class AAGameMail(object):
+
+    def __init__(self):
+        self.apis = [
+            {
+                'name': 'getMailList',
+                'desc': '获取我的邮件列表',
+                'group': '!AAGameMail',
+                'url': 'https://gamemail-test.kingsome.cn/webapp/index.php?c=Mail&a=getMailList',
+                'params': [
+                    _common.ReqHead(),
+                    ['acount_id', '', '账号id'],
+                    ['session_id', '', '会话id'],
+                ],
+                'response': [
+                    _common.RspHead(),
+                    ['!maillist', common.MFGameMail(), '邮件列表'],
+                ]
+            },
+            {
+                'name': 'markMail',
+                'desc': '设置邮件标记',
+                'group': '!AAGameMail',
+                'url': 'https://gamemail-test.kingsome.cn/webapp/index.php?c=Mail&a=markMail',
+                'params': [
+                    _common.ReqHead(),
+                    ['acount_id', '', '账号id'],
+                    ['session_id', '', '会话id'],
+                    ['mail_ids', '', '邮件id列表以","分割'],
+                    ['flag', '', '标志位 read:已读'],
+                ],
+                'response': [
+                    _common.RspHead(),
+                ]
+            },
+            {
+                'name': 'getAttachment',
+                'desc': '领取邮件附件(注意：领取邮件附件后邮件自动删除)',
+                'group': '!AAGameMail',
+                'url': 'https://gamemail-test.kingsome.cn/webapp/index.php?c=Mail&a=getAttachment',
+                'params': [
+                    _common.ReqHead(),
+                    ['acount_id', '', '账号id'],
+                    ['session_id', '', '会话id'],
+                    ['mail_ids', '', '邮件id列表以","分割'],
+                ],
+                'response': [
+                    _common.RspHead(),
+                    ['!attachments', [
+                        ['itemid', 0, '道具id'],
+                        ['itemnum', 0, '道具数量'],
+                    ]],
+                ]
+            },
+            {
+                'name': 'deleteMails',
+                'desc': '删除邮件',
+                'group': '!AAGameMail',
+                'url': 'https://gamemail-test.kingsome.cn/webapp/index.php?c=Mail&a=deleteMails',
+                'params': [
+                    _common.ReqHead(),
+                    ['acount_id', '', '账号id'],
+                    ['session_id', '', '会话id'],
+                    ['mail_ids', '', '邮件id列表以","分割'],
+                ],
+                'response': [
+                    _common.RspHead(),
+                ]
+            },
+        ]
diff --git a/doc/_common.py b/doc/_common.py
index c87a6a96..211c619d 100644
--- a/doc/_common.py
+++ b/doc/_common.py
@@ -1639,3 +1639,22 @@ class MFRoomReportTeam(object):
 
             ['!members', [TeamReportMember()], '成员数据'],
         ]
+
+
+class MFGameMail(object):
+
+    def __init__(self):
+        self.fields = [
+            ['mailid', '', '邮件id'],
+            ['subject', '', '邮件主题'],
+            ['content', '', '邮件正文'],
+            ['flags', 0, '邮件标志 1<<0:已读'],
+            ['sendtime', 0, '发送时间'],
+            ['expiretime', 0, '过期时间'],
+            ['!attachments', [
+                [
+                    ['itemid', 0, '道具id'],
+                    ['itemnum', 0, '道具数量'],
+                ]
+            ], '成员数据'],
+        ]