From 03a7dcb2e61347045e950f04b220fb7b3e6a86f6 Mon Sep 17 00:00:00 2001
From: Yixuan Qiu <yixuanq@gmail.com>
Date: Fri, 20 Mar 2020 12:26:16 -0400
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=8E=86=E5=8F=B2=E5=BC=B9?=
 =?UTF-8?q?=E5=B9=95API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md          |   2 +-
 danmaku/history.md | 105 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 106 insertions(+), 1 deletion(-)
 create mode 100644 danmaku/history.md

diff --git a/README.md b/README.md
index dddde27..2946102 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,7 @@
 - 番剧
 - [视频弹幕](danmaku)
   - [实时弹幕&弹幕格式](danmaku/danmaku.md)√
-  - 历史弹幕
+  - [历史弹幕](danmaku/history.md)√
   - [快照](danmaku/snapshot.md)√
   - 弹幕操作
 - 专栏
diff --git a/danmaku/history.md b/danmaku/history.md
new file mode 100644
index 0000000..18c3009
--- /dev/null
+++ b/danmaku/history.md
@@ -0,0 +1,105 @@
+# 历史弹幕
+
+本页所有操作均需登录（SESSDATA）
+
+## 查询历史弹幕日期
+
+http://api.bilibili.com/x/v2/dm/history/index
+
+*方式：GET*
+
+参数：
+
+| 参数名 | 内容    | 必要性 | 备注 |
+| ------ | ------- | ------ | ---- |
+| type   | 1       | 必要   | 作用尚不明确 |
+| oid    | 视频CID | 必要   |      |
+| month  | 查询月份 | 必要  | mm-dd |
+
+示例：
+
+http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2020-01
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": [
+        "2020-01-21",
+        "2020-01-22",
+        "2020-01-23",
+        "2020-01-24",
+        "2020-01-25",
+        "2020-01-26",
+        "2020-01-27",
+        "2020-01-28",
+        "2020-01-29",
+        "2020-01-30",
+        "2020-01-31"
+    ]
+}
+```
+
+返回结果的 `data` 项说明这些日期有弹幕发送。若查询的月份中视频无弹幕，则 `data` 项为 `null`。
+
+示例：
+
+http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2019-12
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": null
+}
+```
+
+## 获取历史弹幕
+
+https://api.bilibili.com/x/v2/dm/history
+
+*方式：GET*
+
+参数：
+
+| 参数名 | 内容    | 必要性 | 备注 |
+| ------ | ------- | ------ | ---- |
+| type   | 1       | 必要   | 作用尚不明确 |
+| oid    | 视频CID | 必要   |      |
+| date  | 弹幕日期 | 必要  | yyyy-mm-dd |
+
+示例：
+
+https://api.bilibili.com/x/v2/dm/history?type=1&oid=144541892&date=2020-01-21
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<i>
+    <chatserver>chat.bilibili.com</chatserver>
+    <chatid>144541892</chatid>
+    <mission>0</mission>
+    <maxlimit>1500</maxlimit>
+    <state>0</state>
+    <real_name>0</real_name>
+    <d p="473.43400,1,25,15138834,1579622380,0,ec16f2d,27532609919123456">敬礼</d>
+    <d p="3.10200,1,25,16777215,1579622362,0,a2bd7474,27532609920696320">悄默声的更新啊怎么</d>
+    <d p="17.52300,1,25,16777215,1579622357,0,972c932b,27532609906016258">久等了</d>
+    <d p="40.81800,1,25,16777215,1579622343,0,bbca6701,27532609906540546">不都是乱纪元才浸泡</d>
+    <d p="243.39800,1,25,15138834,1579622336,0,77b00ed9,27532609924890624">已阅，狗屁不通。大字报在地上搞搞就行，别弄到天上去</d>
+    <d p="559.80000,1,25,16777215,1579622334,0,9affc7f5,27532609909686274">CSSC。。。</d>
+    <d p="398.29700,1,25,16777215,1579622331,0,18d4707,27532609926463488">看到了个寂寞</d>
+    <d p="34.81000,1,25,38979,1579622327,0,319d7700,27532609926987776">有耳朵了!</d>
+    <d p="18.65700,1,25,16777215,1579622321,0,bbca6701,27532609912307714">雪天不用浸泡吧</d>
+    <d p="305.99800,1,25,16777215,1579622316,0,878c315b,27532609928560640">未来史学派</d>
+    <d p="7.86200,1,25,16777215,1579622309,0,c5136613,27532609913880578">浸泡！！！！！！！</d>
+    <d p="368.95600,1,25,16777215,1579622302,0,18d4707,27532609914404866">章召忠</d>
+    <d p="25.19800,1,25,16777215,1579622286,0,4dab6898,27532609931706368">mi24av</d>
+    <d p="41.10100,1,25,16777215,1579622274,0,33d31036,27532609932230656">泪奔</d>
+    <d p="627.69800,1,25,16777215,1579622264,0,d79a826a,27532609933279232">组建太空军</d>
+    <d p="310.58900,1,25,16777215,1579622243,0,18d4707,27532609918074882">是未来史学派？</d>
+    <d p="723.34800,1,25,16777215,1579622239,0,844fa9e7,27532609919123458">刘培强还行</d>
+    …………
+<i>
+```