diff --git a/README.md b/README.md
index 2d0aa83..7202afb 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,28 @@
-
+
-# 哔哩哔哩-API收集整理
+
哔哩哔哩-API收集整理
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-**野生API文档**
-
-**不断更新中....**
-
-本项目对B站web端以及移动端散落在世界各地的野生api进行收集整理,以及研究使用方法并对其进行说明,运用了黑箱法、控制变量法、js逆向分析法等研究办法
+野生API文档
+不断更新中....
+本项目旨在对B站web端以及移动端散落在世界各地的野生api进行收集整理,以及研究使用方法并对其进行说明,运用了黑箱法、控制变量法、js逆向分析法等研究办法
所有api均为标准http协议,返回值大都为json
-
+
计划整理分类&目录:(√代表已完成,x代表正在施工...)
@@ -98,9 +110,15 @@
- [历史记录](history&toview/play_history.md)√
- [稍后再看](history&toview/toview.md)√
- 收藏夹
-- 课程
+- [课程](cheese)
+ - [课程基本信息](cheese/info.md)√
+ - 已购课程
+ - 分区推荐列表
+ - 操作
+ - 播放&下载地址(视频流)
- [直播](live)
- [直播间基本信息](live/info.md)x
+ - [直播分区](live/live_area.md)×
- [直播间管理](live/manage.md)×
- 直播间操作
- 直播视频流
@@ -150,6 +168,8 @@ https://github.com/Vespa314/bilibili-api
https://github.com/Hsury/Bilibili-Toolkit
+ https://github.com/adachi-sakura/openbilibili-go-common-1
+
成品:
https://github.com/zyzsdy/biliroku
diff --git a/cheese/info.md b/cheese/info.md
new file mode 100644
index 0000000..7018e13
--- /dev/null
+++ b/cheese/info.md
@@ -0,0 +1,604 @@
+# 课程基本信息
+
+课程ssID与epID和番剧不互通
+
+课程avID与普通视频绝大部分api接口不能互通,少部分互通接口如下:
+
+1. 获取视频简介
+2. 查询视频状态数
+3. 查询分P列表
+4. 视频快照
+5. 获取弹幕(使用CID)
+6. 发送弹幕
+7. 高能进度条(使用CID)
+
+## 获取课程基本信息
+
+> http://api.bilibili.com/pugv/view/web/season
+
+*方式:GET*
+
+**参数:**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| --------- | ---- | -------- | ------ | -------------------------------------------------- |
+| season_id | url | 课程ssID | 非必要 | season_id与ep_id任选其一
**与番剧ssID不互通** |
+| ep_id | url | 课程epID | 非必要 | season_id与ep_id任选其一
**与番剧epID不互通** |
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ----------------------- |
+| code | num | 返回值 | 0:成功
-404:错误 |
+| message | str | 错误信息 | 默认为success |
+| data | obj | 信息本体 | |
+
+`data`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------------- | ------ | ----------------------------- | ------------------------------------------------------------ |
+| brief | obj | 课程概述信息 | |
+| coupon | obj | 优惠信息 | 若无优惠则无此项 |
+| cover | str | 课程封面url | |
+| episode_page | obj | 课程分集信息 | |
+| episode_sort | num | 1 | **作用尚不明确** |
+| episodes | arrary | 课程分集列表 | |
+| faq | obj | 常见问题信息1 | 合并格式 |
+| faq1 | obj | 常见问题信息2 | 分离格式 |
+| payment | obj | 付费信息 | |
+| purchase_note | obj | 购买须知信息 | |
+| purchase_protocol | obj | 付费内容协议信息 | |
+| release_bottom_info | str | 底部更新状态文字 | |
+| release_info | str | 更新状态文字+更新连载状态文字 | |
+| release_info2 | str | 更新连载状态文字 | |
+| release_status | str | 更新状态文字 | |
+| season_id | num | 课程ssID | **与番剧ssID不互通** |
+| share_url | str | 页面url | |
+| short_link | str | bilibili uri链接 | |
+| stat | obj | 播放数信息 | |
+| status | num | 10 | **作用尚不明确** |
+| subtitle | str | 课程简介信息 | |
+| title | str | 课程标题 | |
+| up_info | obj | UP主信息 | |
+| user_status | obj | 用户状态信息 | **需要登录(SESSDATA)且referer为`https://www.bilibili.com`** |
+
+`data`中的`brief`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------ | -------- | ---- |
+| content | str | 空 | |
+| img | arrary | 简介图片 | |
+| title | str | 课程概述 | |
+| type | num | 2 | |
+
+`brief`中的`img`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | obj | 简介图片1 | |
+| n | obj | 简介图片(n+1) | |
+| …… | obj | …… | …… |
+
+`img`数组中的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------ | ---- | ----------- | ---------------- |
+| aspect_ratio | num | ??? | **作用尚不明确** |
+| url | str | 简介图片url | |
+
+`data`中的`coupon`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | --------- | ------------------- |
+| amount | num | 折扣乘数 | |
+| expire_time | str | 结束时间 | YYYY-MM-DD HH:MM:SS |
+| start_time | str | 起始时间 | YYYY-MM-DD HH:MM:SS |
+| status | num | ??? | **作用尚不明确** |
+| title | str | 优惠标题 | |
+| token | str | 领取token | |
+
+`data`中的`episode_page`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | -------- | ---- |
+| next | bool | false | |
+| num | num | 1 | |
+| size | num | 总计集数 | |
+| total | num | 总计集数 | |
+
+`data`中的`episodes`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | obj | 课程分集1 | |
+| n | obj | 课程分集(n+1) | |
+| …… | obj | …… | …… |
+
+`episodes`数组中的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
+| aid | num | 课程分集avID | **与普通视频avID部分不互通** |
+| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
+| duration | num | 课程分集时间长度 | 单位为秒 |
+| from | str | pugv | |
+| id | num | 课程分集epID | **与番剧epID不互通** |
+| index | num | 课程分集数 | |
+| page | num | 1 | |
+| play | num | 课程分集播放量 | |
+| release_date | num | 课程分集发布时间 | 时间戳 |
+| status | num | 分集属性 | 1:可免费试看
2:需要付费观看 |
+| title | str | 课程分集标题 | |
+| watched | bool | 是否观看该集 | **需要登录(SESSDATA)且referer为`https://www.bilibili.com`**
false:未观看
true:已观看 |
+| watchedHistory | num | 该集观看历史 | **需要登录(SESSDATA)且referer为`https://www.bilibili.com`** |
+
+`data`中的`faq`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | --------------- | ---- |
+| content | str | 常见问题信息 | |
+| link | str | 常见问题页面url | |
+| title | str | 常见问题 | |
+
+`data`中的`faq1`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ------ | ------------ | ---- |
+| items | arrary | 常见问题列表 | |
+| title | str | 常见问题 | |
+
+`faq1`中的`items`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | obj | 常见问题1 | |
+| n | obj | 常见问题(n+1) | |
+| …… | obj | …… | …… |
+
+`items`数组中的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | ---- |
+| answer | str | 回答信息 | |
+| question | str | 问题信息 | |
+
+`data`中的`payment`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------------- | ---- | -------------------- | ----------------------- |
+| desc | str | 付费价格说明 | |
+| discount_desc | str | 折扣说明信息 | 若无优惠则无此项 |
+| discount_prefix | str | 折扣类型前缀 | 若无优惠则无此项 |
+| pay_shade | str | 观看所有视频付费说明 | |
+| price | num | 课程价格 | 单位为B币(折扣后价格) |
+| price_format | str | 课程价格 | 单位为B币折扣后价格) |
+
+`data`中的`purchase_note`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------------------- | ---- |
+| content | str | 购买须知信息文字内容 | |
+| link | str | 购买须知页面url | |
+| title | str | 购买须知 | |
+
+`data`中的`purchase_protocol`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | ------------------- | ---- |
+| link | str | 付费内容协议页面url | |
+| title | str | 付费内容协议 | |
+
+`data`中的`stat`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------- | ---- | -------------- | ---- |
+| play | num | 播放量 | |
+| play_desc | str | 播放量文字信息 | |
+
+`data`中的`up_info`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------- | ---- | ------------ | ------------------------------------------------------------ |
+| avatar | str | UP主头像url | |
+| brief | str | UP主备注 | 非个人签名 |
+| follower | num | UP主粉丝数 | |
+| is_follow | num | 是否关注UP主 | **需要登录(SESSDATA)且referer为`https://www.bilibili.com`**
0:未关注
1:已关注 |
+| link | str | UP主空间url | |
+| mid | num | UP主uid | |
+| pendant | obj | ??? | **作用尚不明确** |
+| uname | str | UP主昵称 | |
+
+`up_info`中的`pendant`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | ---- | ---------------- |
+| image | str | 空 | **作用尚不明确** |
+| name | str | 空 | **作用尚不明确** |
+| follower | num | 0 | **作用尚不明确** |
+
+`data`中的`user_status`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------- | ---- | -------- | ------------------------ |
+| favored | num | 是否收藏 | 0:未收藏
1:已收藏 |
+| favored_count | num | 1 | **作用尚不明确** |
+| payed | num | 是否购买 | 0:未购买
1:已购买 |
+| progress | obj | 课程进度 | 未登录无此项 |
+
+`user_status`中的`progress`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------- | ---- | ------------------ | -------- |
+| last_ep_id | num | 最后观看的epID | |
+| last_ep_index | str | 最后观看的标题 | |
+| last_time | num | 最后观看的时间进度 | 单位为秒 |
+
+**示例:**
+
+查询课程`ss61`或分集`ep790`的信息
+
+http://api.bilibili.com/pugv/view/web/season?season_id=61
+
+同 http://api.bilibili.com/pugv/view/web/season?ep_id=790
+
+```json
+{
+ "code": 0,
+ "data": {
+ "brief": {
+ "content": "",
+ "img": [
+ {
+ "aspect_ratio": 0.9375,
+ "url": "http://i0.hdslb.com/bfs/archive/29942f338ee570632838403a09871bad130cfe9a.jpg"
+ },
+ {
+ "aspect_ratio": 0.9375,
+ "url": "http://i0.hdslb.com/bfs/archive/913e5c37d836d7954ae9ca19da62a43ba5b34219.jpg"
+ },
+ {
+ "aspect_ratio": 1.3359375,
+ "url": "http://i0.hdslb.com/bfs/archive/a974555bd4a52f0aa865bd192c1e3401ed4cb0ad.jpg"
+ },
+ {
+ "aspect_ratio": 1.3359375,
+ "url": "http://i0.hdslb.com/bfs/archive/73cd7669b251db9d2b62b921bee49a137c3d65dc.jpg"
+ },
+ {
+ "aspect_ratio": 1.0625,
+ "url": "http://i0.hdslb.com/bfs/archive/b084ac8f6710c8eddbc58770a4254508de75eb02.jpg"
+ },
+ {
+ "aspect_ratio": 1.2890625,
+ "url": "http://i0.hdslb.com/bfs/archive/44e32c2cf64b894563829ce65bbef199220f4121.jpg"
+ },
+ {
+ "aspect_ratio": 1.3203125,
+ "url": "http://i0.hdslb.com/bfs/archive/90764fd095810565713b92606dc9cd0cfb25adae.jpg"
+ },
+ {
+ "aspect_ratio": 1.15234375,
+ "url": "http://i0.hdslb.com/bfs/archive/c35ca0ced0ad075a2c13b8fdc1e47b88573bce45.jpg"
+ }
+ ],
+ "title": "课程概述",
+ "type": 2
+ },
+ "coupon": {
+ "amount": 0.66,
+ "expire_time": "2020-06-30 00:00:00",
+ "start_time": "2020-05-21 00:00:00",
+ "status": 1,
+ "title": "【上新限时6.6折】《唐盾:0-N4日语精讲》",
+ "token": "B20200521135929161905873"
+ },
+ "cover": "http://i0.hdslb.com/bfs/archive/95d4de9e6691ccc2b18f087f5f654652dee3c01b.jpg",
+ "episode_page": {
+ "next": false,
+ "num": 1,
+ "size": 66,
+ "total": 66
+ },
+ "episode_sort": 1,
+ "episodes": [
+ {
+ "aid": 76973173,
+ "cid": 132105993,
+ "duration": 2223,
+ "from": "pugv",
+ "id": 790,
+ "index": 1,
+ "page": 1,
+ "play": 2406406,
+ "release_date": 1574762407,
+ "status": 1,
+ "title": "唐盾:一起从0基础学日语吧(含50音 词汇试听)",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ {
+ "aid": 77114885,
+ "cid": 132110244,
+ "duration": 3003,
+ "from": "pugv",
+ "id": 795,
+ "index": 2,
+ "page": 1,
+ "play": 49100,
+ "release_date": 1574766759,
+ "status": 2,
+ "title": "50音あ行假名/音调/送气与不送气音",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ {
+ "aid": 77120689,
+ "cid": 131913553,
+ "duration": 3253,
+ "from": "pugv",
+ "id": 797,
+ "index": 3,
+ "page": 1,
+ "play": 49518,
+ "release_date": 1574770029,
+ "status": 2,
+ "title": "50音图的か行、さ行、た行假名",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ …………
+ ],
+ "faq": {
+ "content": "Q:课程在什么时间更新?\nA:课程更新频次以页面前端展示为准。购买成功后,课程更新将通过账号动态提示,方便及时观看。\n\nQ:课程购买后有收看时间限制吗?\nA:购买后除不可抗力因素外,课程均可永久收看,请您放心购买。\n\nQ:原价购买课程后,如遇到优惠折扣,是否可以退还差价或重新购买?\nA:虚拟商品付款后无法返还,请您随时留意各类课程折扣信息,按需购买。\n\nQ:购买课程后是否可以加入老师的粉丝群或者用户群?\nA:如老师设置用户群,我们将邀您加入,但我们无法承诺所有老师均提供用户群服务,感谢理解。",
+ "link": "http://m.bilibili.com",
+ "title": "常见问题"
+ },
+ "faq1": {
+ "items": [
+ {
+ "answer": "课程更新频次以页面前端展示为准。购买成功后,课程更新将通过账号动态提示,方便及时观看。",
+ "question": "课程在什么时间更新?"
+ },
+ {
+ "answer": "购买后除不可抗力因素外,课程均可永久收看,请您放心购买。",
+ "question": "课程购买后有收看时间限制吗?"
+ },
+ {
+ "answer": "虚拟商品付款后无法返还,请您随时留意各类课程折扣信息,按需购买。",
+ "question": "原价购买课程后,如遇到优惠折扣,是否可以退还差价或重新购买?"
+ },
+ {
+ "answer": "如老师设置用户群,我们将邀您加入,但我们无法承诺所有老师均提供用户群服务,感谢理解。",
+ "question": "购买课程后是否可以加入老师的粉丝群或者用户群?"
+ }
+ ],
+ "title": "常见问题"
+ },
+ "payment": {
+ "desc": "券后 262.68 B币起/53期",
+ "discount_desc": "262.68 B币",
+ "discount_prefix": "券后",
+ "pay_shade": "券后支付 262.68 B币即可观看所有视频",
+ "price": 398.0,
+ "price_format": "398"
+ },
+ "purchase_note": {
+ "content": "1. 本内容为付费内容,购买成功后方可观看。
2. 本内容为虚拟服务,已购买内容不支持退款,敬请谅解。
3. 实际购买价格以页面展示的价格及订单结算页显示价格为准。
4. 如您在购买付费内容时有任何疑问,可随时咨询在线客服。
完整的购买协议,请点击阅读《bilibili付费内容购买协议》",
+ "link": "https://www.bilibili.com/blackboard/activity-y-SJTTYBp.html",
+ "title": "购买须知"
+ },
+ "purchase_protocol": {
+ "link": "https://www.bilibili.com/blackboard/activity-y-SJTTYBp.html",
+ "title": "bilibili付费内容购买协议"
+ },
+ "release_bottom_info": "没有更多啦~",
+ "release_info": "已完结,共53期",
+ "release_info2": "共53期",
+ "release_status": "已完结",
+ "season_id": 61,
+ "share_url": "https://m.bilibili.com/cheese/play/ss61",
+ "short_link": "bilibili://cheese/season/61",
+ "stat": {
+ "play": 2878146,
+ "play_desc": "287.8万播放"
+ },
+ "status": 10,
+ "subtitle": "新东方名师唐盾的精品日语课,包含50音/N5/N4的词汇/语法/课文/练习精讲,让我们一起轻松学日语~",
+ "title": "唐盾:0-N4日语精讲",
+ "up_info": {
+ "avatar": "http://i1.hdslb.com/bfs/face/564421428d1f74314ed50e16a8f570ad968828b0.jpg",
+ "brief": "唐盾:前新东方日语名师,倾注日语教学、翻译14年。曾任新东方欧亚教育长沙中心总监。",
+ "follower": 21333,
+ "is_follow": 0,
+ "link": "https://space.bilibili.com/19452605",
+ "mid": 19452605,
+ "pendant": {
+ "image": "",
+ "name": "",
+ "pid": 0
+ },
+ "uname": "盾盾桑教你学日语"
+ },
+ "user_status": {
+ "favored": 1,
+ "favored_count": 1,
+ "payed": 0,
+ "progress": {
+ "last_ep_id": 790,
+ "last_ep_index": "唐盾:一起从0基础学日语吧(含50音 词汇试听)",
+ "last_time": 1
+ }
+ }
+ },
+ "message": "success"
+}
+```
+
+
+
+## 获取课程分集列表
+
+> http://api.bilibili.com/pugv/view/web/ep/list
+
+*方式:GET*
+
+**参数:**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| --------- | ---- | -------- | ------ | -------------------- |
+| season_id | url | 课程ssID | 必要 | **与番剧ssID不互通** |
+| ps | url | 每页项数 | 非必要 | 默认为50 |
+| pn | url | 页码 | 非必要 | 默认为1 |
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ----------------------- |
+| code | num | 返回值 | 0:成功
-404:错误 |
+| message | str | 错误信息 | 默认为success |
+| data | obj | 信息本体 | |
+
+`data`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ------ | ------------ | ---- |
+| items | arrary | 课程分集列表 | |
+| page | obj | 列表分页信息 | |
+
+`data`中的`items`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | obj | 课程分集1 | |
+| n | obj | 课程分集(n+1) | |
+| …… | obj | …… | …… |
+
+`items`数组中的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
+| aid | num | 课程分集avID | **与普通视频avID部分不互通** |
+| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
+| duration | num | 课程分集时间长度 | 单位为秒 |
+| from | str | pugv | |
+| id | num | 课程分集epID | **与番剧epID不互通** |
+| index | num | 课程分集数 | |
+| page | num | 1 | |
+| play | num | 课程分集播放量 | |
+| release_date | num | 课程分集发布时间 | 时间戳 |
+| status | num | 分集属性 | 1:可免费试看
2:需要付费观看 |
+| title | str | 课程分集标题 | |
+| watched | bool | 是否观看该集 | **需要登录(SESSDATA)且referer为`https://www.bilibili.com`**
false:未观看
true:已观看 |
+| watchedHistory | num | 该集观看历史 | **需要登录(SESSDATA)且referer为`https://www.bilibili.com`** |
+
+`data`中的`page`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | -------------- | ----------------------------------------- |
+| next | bool | 是否存在下一页 | false:不存在下一页
true:存在下一页 |
+| num | num | 当前页码 | |
+| size | num | 每页项数 | |
+| total | num | 总价项数 | |
+
+**示例:**
+
+按照每页5项查询课程`ss61`的分集列表第1页
+
+ http://api.bilibili.com/pugv/view/web/ep/list?season_id=61&pn=1&ps=5
+
+```json
+{
+ "code": 0,
+ "data": {
+ "items": [
+ {
+ "aid": 76973173,
+ "cid": 132105993,
+ "duration": 2223,
+ "from": "pugv",
+ "id": 790,
+ "index": 1,
+ "page": 1,
+ "play": 2406951,
+ "release_date": 1574762407,
+ "status": 1,
+ "title": "唐盾:一起从0基础学日语吧(含50音 词汇试听)",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ {
+ "aid": 77114885,
+ "cid": 132110244,
+ "duration": 3003,
+ "from": "pugv",
+ "id": 795,
+ "index": 2,
+ "page": 1,
+ "play": 49106,
+ "release_date": 1574766759,
+ "status": 2,
+ "title": "50音あ行假名/音调/送气与不送气音",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ {
+ "aid": 77120689,
+ "cid": 131913553,
+ "duration": 3253,
+ "from": "pugv",
+ "id": 797,
+ "index": 3,
+ "page": 1,
+ "play": 49522,
+ "release_date": 1574770029,
+ "status": 2,
+ "title": "50音图的か行、さ行、た行假名",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ {
+ "aid": 77606110,
+ "cid": 132897199,
+ "duration": 2823,
+ "from": "pugv",
+ "id": 806,
+ "index": 4,
+ "page": 1,
+ "play": 35800,
+ "release_date": 1575128696,
+ "status": 2,
+ "title": "50音图的な行、は行、ま行假名",
+ "watched": false,
+ "watchedHistory": 0
+ },
+ {
+ "aid": 78015255,
+ "cid": 133651764,
+ "duration": 2165,
+ "from": "pugv",
+ "id": 812,
+ "index": 5,
+ "page": 1,
+ "play": 25842,
+ "release_date": 1575446218,
+ "status": 2,
+ "title": "や行、ら行、わ行假名、拨音",
+ "watched": false,
+ "watchedHistory": 0
+ }
+ ],
+ "page": {
+ "next": true,
+ "num": 1,
+ "size": 5,
+ "total": 66
+ }
+ },
+ "message": "success"
+}
+```
+
diff --git a/live/live_area.md b/live/live_area.md
new file mode 100644
index 0000000..3e62991
--- /dev/null
+++ b/live/live_area.md
@@ -0,0 +1,204 @@
+# 直播间分区
+
+## 获取全部直播间分区列表
+
+> http://api.live.bilibili.com/room/v1/Area/getList
+
+*方式:GET*
+
+直播分区共有两级,分别是父分区和子分区
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------ | ---------- | ------------- |
+| code | num | 返回值 | 0:成功 |
+| msg | str | 错误信息 | 默认为success |
+| message | str | 错误信息 | 默认为success |
+| data | arrary | 父分区列表 | |
+
+`data`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------- | ---- |
+| 0 | obj | 父分区1 | |
+| n | obj | 父分区(n+1) | |
+| …… | obj | …… | …… |
+
+`data`数组中的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---------- | ---- |
+| id | num | 父分区ID | |
+| name | name | 父分区名 | |
+| list | list | 子分区列表 | |
+
+`data`数组中的对象中的`list`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ----------- | ---- |
+| 0 | obj | 子分区1 | |
+| n | obj | 子分区(n+1) | |
+| …… | obj | …… | …… |
+
+`list`数组中的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | ----------------- | ---------------- |
+| id | str | 子分区ID | |
+| parent_id | str | 父分区ID | |
+| old_area_id | str | 旧分区ID | |
+| name | str | 子分区名 | |
+| act_id | str | 0 | **作用尚不明确** |
+| pk_status | str | ??? | **作用尚不明确** |
+| hot_status | num | 是否为热门分区 | 0:否
1:是 |
+| lock_status | str | 0 | **作用尚不明确** |
+| pic | str | 子分区标志图片url | |
+| parent_name | str | 父分区名 | |
+| area_type | num | | |
+
+**示例:**
+
+如想在`网游`父分区下的`英雄联盟`分区开播,需要取得子分区ID`86`
+
+http://api.live.bilibili.com/room/v1/Area/getList
+
+```json
+{
+ "code": 0,
+ "msg": "success",
+ "message": "success",
+ "data": [
+ {
+ "id": 2,
+ "name": "网游",
+ "list": [
+ {
+ "id": "86",
+ "parent_id": "2",
+ "old_area_id": "4",
+ "name": "英雄联盟",
+ "act_id": "0",
+ "pk_status": "0",
+ "hot_status": 1,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/dcfb14f14ec83e503147a262e7607858b05d7ac0.png",
+ "parent_name": "网游",
+ "area_type": 0
+ },
+ {
+ "id": "252",
+ "parent_id": "2",
+ "old_area_id": "3",
+ "name": "逃离塔科夫",
+ "act_id": "0",
+ "pk_status": "0",
+ "hot_status": 1,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/762a7de3dd5fe8165d1d55b232484a017941592f.png",
+ "parent_name": "网游",
+ "area_type": 0
+ },
+ {
+ "id": "80",
+ "parent_id": "2",
+ "old_area_id": "1",
+ "name": "绝地求生",
+ "act_id": "0",
+ "pk_status": "0",
+ "hot_status": 1,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/43ca83fdcd10505eaeef1b76cf8ce642a53b94da.png",
+ "parent_name": "网游",
+ "area_type": 0
+ },
+ …………
+ ]
+ },
+ {
+ "id": 3,
+ "name": "手游",
+ "list": [
+ {
+ "id": "35",
+ "parent_id": "3",
+ "old_area_id": "12",
+ "name": "王者荣耀",
+ "act_id": "0",
+ "pk_status": "0",
+ "hot_status": 1,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/0fefa924760b2dd492a12dddafe179bfa1216918.png",
+ "parent_name": "手游",
+ "area_type": 0
+ },
+ …………
+ ]
+ },
+ {
+ "id": 6,
+ "name": "单机",
+ "list": [
+ {
+ "id": "236",
+ "parent_id": "6",
+ "old_area_id": "1",
+ "name": "主机游戏",
+ "act_id": "0",
+ "pk_status": "0",
+ "hot_status": 1,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/edb636ee59f902e3134a2790545045bddd70978e.png",
+ "parent_name": "单机",
+ "area_type": 0
+ },
+ …………
+ ]
+ },
+ {
+ "id": 1,
+ "name": "娱乐",
+ "list": [
+ {
+ "id": "21",
+ "parent_id": "1",
+ "old_area_id": "10",
+ "name": "视频唱见",
+ "act_id": "0",
+ "pk_status": "1",
+ "hot_status": 1,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/72b93ddafdf63c9f0b626ad546847a3c03c92b6f.png",
+ "cate_id": "12",
+ "parent_name": "娱乐",
+ "area_type": 0
+ },
+ …………
+ ]
+ },
+ {
+ "id": 5,
+ "name": "电台",
+ "list": [
+ {
+ "id": "190",
+ "parent_id": "5",
+ "old_area_id": "10",
+ "name": "唱见电台",
+ "act_id": "0",
+ "pk_status": "0",
+ "hot_status": 0,
+ "lock_status": "0",
+ "pic": "http://i0.hdslb.com/bfs/vc/d22d7fafbf9b24e2bc3ce1df5eb9f006e6035e5d.png",
+ "parent_name": "电台",
+ "area_type": 0
+ },
+ …………
+ ]
+ }
+ ]
+}
+```
+
diff --git a/live/manage.md b/live/manage.md
index 7721f95..a1fa647 100644
--- a/live/manage.md
+++ b/live/manage.md
@@ -58,12 +58,12 @@ curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&title=%E6%B5%8B%E8%AF%9
**参数( application/x-www-form-urlencoded ):**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| -------- | ---- | ------------------- | ------ | -------------------- |
-| room_id | data | 直播间ID | 必要 | 必须为自己的直播间ID |
-| area_v2 | data | 直播分区ID | 必要 | 最大20字符 |
-| platform | data | pc | 必要 | |
-| csrf | data | cookies中的bili_jct | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ---------------------- | ------ | ---------------------------- |
+| room_id | data | 直播间ID | 必要 | 必须为自己的直播间ID |
+| area_v2 | data | 直播分区ID(子分区ID) | 必要 | 详见[直播分区](live_area.md) |
+| platform | data | 必须为`pc` | 必要 | |
+| csrf | data | cookies中的bili_jct | 必要 | |
**json回复:**
diff --git a/video/info.md b/video/info.md
index 80a172c..57496ea 100644
--- a/video/info.md
+++ b/video/info.md
@@ -2,7 +2,7 @@
-## 视频详细信息(avID/bvID互转及转epID)
+## 获取视频详细信息(avID/bvID互转及转epID)
> http://api.bilibili.com/x/web-interface/view
@@ -349,7 +349,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
-## 视频简介
+## 获取视频简介
> http://api.bilibili.com/x/web-interface/archive/desc
@@ -392,7 +392,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
-## 视频分P列表 (avID/bvID转CID)
+## 查询视频分P列表 (avID/bvID转CID)
> http://api.bilibili.com/x/player/pagelist