Update docs

CHANGELOG.md

@@ -20,7 +20,7 @@
 + MiraiCode 消息类型支持，可将 MiraiCode 作为一种消息类型 [消息格式](https://github.com/project-mirai/mirai-api-http/blob/master/docs/api/MessageType.md#miraicode) [MiraiCode的使用](https://github.com/mamoe/mirai/blob/dev/docs/Messages.md#%E6%B6%88%E6%81%AF%E5%85%83%E7%B4%A0)
 + `Webhook Adapter` 对请求头 `qq`, `bot` 追加可反代的 `X-header` 格式
 + 配置文件中智能的 host 解析, 默认解析到 `http://` scheme
-
++ 群文件请求 `/file/list`, `/file/info` 可携带 `withDownloadInfo` 返回额外的下载信息 [查看文件列表](https://github.com/project-mirai/mirai-api-http/blob/master/docs/api/API.md#查看文件列表)
 
 
 ## \[2.1.0\] - 2021-07-19

docs/api/API.md

@@ -491,7 +491,8 @@
   "id": "",
   "target":987654321,
   "group":null,
-  "qq":null
+  "qq":null,
+  "withDownloadInfo":true
 }
 ```
 
@@ -502,6 +503,7 @@
 | target       | Long   | true  | 987654321   | 群号或好友QQ号                   |
 | group        | Long   | true  | 987654321   | 群号                            |
 | qq           | Long   | true  | 987654321   | 好友QQ号                        |
+| withDownloadInfo | Boolean | true  | true   | 是否携带下载信息，额外请求，无必要不要携带 |
 
 #### 响应:
 
@@ -509,7 +511,7 @@
 {
   "code":0,
   "msg":"",
-  "data":[
+  "data": [
     {
       "name":"setu.png",
       "id":"/12314d-1wf13-a98ffa",
@@ -522,7 +524,12 @@
       },
       "isFile":true,
       "isDictionary":false,
-      "isDirectory":false
+      "isDirectory":false,
+      "downloadInfo":{
+        "sha1":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "md5":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "url":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+      }
     }
   ]
 }
@@ -539,6 +546,10 @@
 | data.isFile  | Boolean | 是否文件                         |
 | data.isDictionary | Boolean | ~~是否文件夹~~(弃用)                  |
 | data.isDirectory | Boolean | 是否文件夹                  |
+| downloadInfo | Object | 文件下载信息                  |
+| downloadInfo.sha1 | String | 文件sha1校验                  |
+| downloadInfo.md5 | String | 文件md5校验               |
+| downloadInfo.url | String | 文件下载url                  |
 
 ### 获取文件信息
 
@@ -550,7 +561,8 @@
   "id": "",
   "target":987654321,
   "group":null,
-  "qq":null
+  "qq":null,
+  "withDownloadInfo":true
 }
 ```
 
@@ -561,6 +573,7 @@
 | target       | Long   | true  | 987654321   | 群号或好友QQ号                   |
 | group        | Long   | true  | 987654321   | 群号                            |
 | qq           | Long   | true  | 987654321   | 好友QQ号                        |
+| withDownloadInfo | Boolean | true  | true   | 是否携带下载信息，额外请求，无必要不要携带 |
 
 #### 响应:
 
@@ -580,7 +593,12 @@
     },
     "isFile":true,
     "isDictionary":false,
-    "isDirectory":false
+    "isDirectory":false,
+    "downloadInfo":{
+      "sha1":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+      "md5":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+      "url":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+    }
   }
 }
 ```
@@ -596,6 +614,10 @@
 | data.isFile  | Boolean | 是否文件                         |
 | data.isDictionary | Boolean | ~~是否文件夹~~(弃用)                  |
 | data.isDirectory | Boolean | 是否文件夹                  |
+| downloadInfo | Object | 文件下载信息                  |
+| downloadInfo.sha1 | String | 文件sha1校验                  |
+| downloadInfo.md5 | String | 文件md5校验               |
+| downloadInfo.url | String | 文件下载url                  |
 
 ### 创建文件夹