add: 添加暂未编写完成的api(user/message-record.md)

Author: lambdark

README.md

@@ -27,6 +27,7 @@ Codemao API 项目由编程猫社区用户发起，旨在为广大训练师提
    - 如果请求不需要用到 cookie，不会专门标注
 
 2. API 中的`返回内容`栏目表现的是请求成功的理想状态
+3. `10|[5,200]`中 10 表示默认值为 10，`|`后面为取值范围（区间表示，取整数），此处最小为 5，最大为 200
 
 ## 加入我们
 

_sidebar.md

@@ -3,7 +3,8 @@
   - [修改用户信息](/user/update-info)
   - [设置用户名](/user/set-username)
   - [修改用户密码](/user/update-password)
-  - [消息](/user/messages)
+  - [新消息数量](/user/message-count)
+  - [消息记录](/user/message-record)
   - [个人信息（details）](/user/details)
   - [个人信息（info）](/user/info)
   - [其他用户信息](/user/user-details)

user/messages.md user/message-count.md

@@ -1,6 +1,6 @@
-# 消息
+# 新消息数量
 
-> 获取新消息数量  
+> 获取自己的新消息数量  
 > `/web/message-record/count` `GET` `需要cookies`
 
 ## 返回内容
@@ -14,11 +14,11 @@
 
 ### `query_type`说明： :id=description_query_type
 
-|    类型    |      值       |
-| :--------: | :-----------: |
-| 评论与回复 | COMMENT_REPLY |
-| 赞与被购买 |   LIKE_FORK   |
-|  系统消息  |    SYSTEM     |
+|     value     | description |
+| :-----------: | :---------: |
+| COMMENT_REPLY | 评论与回复  |
+|   LIKE_FORK   | 赞与被购买  |
+|    SYSTEM     |  系统消息   |
 
 ### 示例
 

user/message-record.md

@@ -0,0 +1,67 @@
+# 消息记录
+
+!> 这个 API 文档正在编写中，请勿使用
+
+> 获取自己的消息记录  
+> `/web/message-record` `GET` `需要cookies`
+
+## URL 参数
+
+|                  key                  |           value           |  type  |        |
+| :-----------------------------------: | :-----------------------: | :----: | :----: |
+| [query_type](#description_query_type) |         消息类型          | string | `必须` |
+|                 limit                 | 每一页的数量`10\|[5,200]` |  int   | `可选` |
+|                offset                 |           页码            |  int   | `可选` |
+
+### `query_type`说明： :id=description_query_type
+
+|     value     | description |
+| :-----------: | :---------: |
+| COMMENT_REPLY | 评论与回复  |
+|   LIKE_FORK   | 赞与被购买  |
+|    SYSTEM     |  系统消息   |
+
+## 返回内容
+
+|   key   |                      value                       | type |
+| :-----: | :----------------------------------------------: | :--: |
+|  items  | 由多个 JSON 构成的消息列表（[查看详情](#items)） | list |
+| offset  |                       页码                       | int  |
+|  limit  |                   每一页的数量                   | int  |
+|  total  |                      `未知`                      | int  |
+| counted |                      `未知`                      | bool |
+
+### items
+
+|     key      |                  value                   |  type  |
+| :----------: | :--------------------------------------: | :----: |
+|      id      |                 消息 ID                  | string |
+|     type     |      消息类型（[查看详情](#type)）       | string |
+|   content    |   消息具体内容（[查看详情](#content)）   | string |
+| reference_id |                  `未知`                  | string |
+|  sender_id   |              消息发送者 ID               | string |
+| receiver_id  |              消息接收者 ID               | string |
+| read_status  | 阅读状态（`READ`为已读，`UNREAD`为未读） | string |
+|  created_at  |              消息产生时间戳              |  int   |
+
+#### type
+
+|           value           |    description     |
+| :-----------------------: | :----------------: |
+|       WORK_COMMENT        |     作品被评论     |
+|        WORK_REPLY         | 作品下的评论被回复 |
+|     WORK_REPLY_AUTHOR     |                    |
+| WORK_REPLY_REPLY_FEEDBACK |                    |
+|       POST_COMMENT        |                    |
+|        POST_REPLY         |                    |
+|     POST_REPLY_REPLY      |                    |
+| POST_REPLY_REPLY_FEEDBACK |                    |
+|         WORK_FORK         |     作品被购买     |
+|         WORK_LIKE         |     作品被点赞     |
+|   WORK_DISCUSSION_LIKED   |                    |
+|   POST_DISCUSSION_LIKED   |                    |
+|         BROADCAST         |                    |
+
+#### content
+
+> 更新于 2023.01.18