新增了一个API (#383)

* 新增了入站必刷85个视频 * 修复了一些错误 * 修复了一些错误
2025-02-05 16:50:08 +08:00 · 2022-06-06 16:38:50 +08:00 · 2022-06-06 16:38:50 +08:00 · fcaee7dba5
commit fcaee7dba5
parent dec9181f39
2 changed files with 199 additions and 10 deletions
--- a/APP_widget/splash.md
+++ b/APP_widget/splash.md
@ -85,10 +85,6 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \

 <details>
 <summary>查看响应示例：</summary>
-<<<<<<< HEAD
-=======
-<!--
->>>>>>> d4f20b5a37730a3665341ec41a48b333bd133ac0
 ```json
 {
    "code": 0,
@ -152,10 +148,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
 *请求方式: GET*

 | 参数名 | 类型 | 内容       | 必要性      | 备注 |
-<<<<<<< HEAD
 | - | - | - | - | - |
-=======
->>>>>>> d4f20b5a37730a3665341ec41a48b333bd133ac0
 | build | int | 客户端内部版本号 | 必要 | |
 | mobi_app | str | android, iphone, ipad | 必要 | |
 | platform | str | android, ios | 必要 | |
@ -175,10 +168,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
 `data` 字段：

 | 字段    | 类型 | 内容     | 备注                                                 |
-<<<<<<< HEAD
 | - | - | - | - |
-=======
->>>>>>> d4f20b5a37730a3665341ec41a48b333bd133ac0
 | splash_request_id | str | 不知道 | |
 | max_time | int | 最长显示时间？ | |
 | min_interval | int | 最少显示时间？ | 千分之一秒单位 |
--- a/ranking&dynamic/85videos.md
+++ b/ranking&dynamic/85videos.md
@ -0,0 +1,199 @@
+<!--{
+    "info": {
+        "hot": {
+            "url": "http://api.bilibili.com/x/web-interface/popular", 
+            "verify": false, 
+            "comment": "小破站的热门视频排行"
+        }, 
+        "weakly_series": {
+            "url": "http://api.bilibili.com/x/web-interface/popular/series/list", 
+            "verify": false, 
+            "comment": "小破站每周必看全部信息（简介）"
+        }, 
+        "weakly_details": {
+            "url": "http://api.bilibili.com/x/web-interface/popular/series/one", 
+            "verify": false, 
+            "params": {
+                "number": "int: 第几周"
+            }, 
+            "comment": "小破站每周必看一期的详细信息"
+        }, 
+        "popular": {
+            "url": "http://api.bilibili.com/x/web-interface/popular/precious", 
+            "verify": false, 
+            "params": {
+                "page_size": "int: 就设置 85 好了（每页的大小）", 
+                "page": "int: 页码"
+            }, 
+            "comment": "获取入站必刷 85 个视频"
+        }, 
+        "ranking": {
+            "url": "http://api.bilibili.com/x/web-interface/ranking/v2", 
+            "verify": false, 
+            "params": {
+                "tid": "int: 频道的 tid", 
+                "type": "string: all"
+            }, 
+            "comment": "获取各个分区的排行榜"
+        }
+    }
+}
+-->
+
+# 入站必刷
+
+[获取入站必刷85个视频](#85videos)
+
+<span id="85videos">## 获取入站必刷85个视频</span>
+
+> http://api.bilibili.com/x/web-interface/popular/precious
+
+**url参数**
+
+| 字段    | 类型  | 内容     | 必要性 ｜ 备注                        |
+| - | - | - | - | - |
+| page | int | 第几页 | 不必要 | 默认为1 |
+| page_size | int | 每一页的视频数 | 不必要 | 可以设为 85 获取所有的视频 |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型  | 内容     | 备注                        |
+| ------- | ----- | -------- | --------------------------- |
+| code    | num   | 返回值   | 0：成功<br />-400：请求错误 |
+| message | str   | 错误信息 | 默认为0                     |
+| ttl     | num   | 1        |                             |
+| data    | array | 视频列表 |                             |
+
+`data` 字段：
+
+| 字段    | 类型  | 内容     | 备注                        |
+| - | - | - | - |
+| title | string | 标题 | 入站必刷 |
+| media_id | int | media_id | |
+| explain | string | 解释（概括）| 我不允许还有人没看过这85个宝藏视频！ |
+| list | list | 列表 | |
+
+`data` 中的 `list` 字段：
+
+| 字段    | 类型  | 内容     | 备注                        |
+| - | - | - | - |
+| aid | int | aid | |
+| videos | int | 视频数? | |
+| tid | int | 分区 id | |
+| tname | string | 分区名称 | |
+| copyright | int | 版权 | ｜
+| pic | url | 封面 url | |
+| title | string | 标题 | |
+| pubdate | int | 发布时间 | 时间戳 |
+| ctime | int | 暂不清楚 | 时间戳 |
+| desc | string | 简介 | |
+| state | int | 暂不清楚 | |
+| duration | int | 视频时长 | 单位为秒 |
+| mission_id | int | 暂不清楚 | |
+| rights | dict | 暂不清楚 | 好像没啥么用 |
+| owner | dict | 作者 | |
+| stat | dict | 状态 | |
+| dynamic | string | 动态发布时写的文字 | |
+| cid | int | cid | |
+| dimension | dict | 视频的一些属性 | |
+| season_id | int | 暂不清楚 ｜ |
+| short_link | string | 短链 | |
+| short_link_v2 | string | 短链 | 第二版 |
+| bvid | string | bvid | |
+| season_type | int | 分区 tid? | |
+| is_ogv | bool | 暂不清楚 | |
+| ogv_info | dict/null? | 暂不清楚 | |
+| rcmd_reason | string? | 暂不清楚 | |
+| achievement | string | 荣誉概述 | |
+
+**示例：**
+
+``` shell
+curl 'http://api.bilibili.com/x/web-interface/popular/precious'
+```
+<details>
+<summary>查看响应事例:</summary>
+
+``` json
+{
+    "code":0,
+    "message":"0",
+    "ttl":1,
+    "data":{
+        "title":"入站必刷",
+        "media_id":496307088,
+        "explain":"我不允许还有人没看过这85个宝藏视频！",
+        "list":[
+            {
+                "aid":715024588,
+                "videos":1,
+                "tid":233,
+                "tname":"极客DIY",
+                "copyright":1,
+                "pic":"http://i1.hdslb.com/bfs/archive/55ce9a4d1797ec56a0d4ed727f1a279b89ec3664.jpg",
+                "title":"【才浅】15天花20万元用500克黄金敲数万锤纯手工打造三星堆黄金面具",
+                "pubdate":1618207101,
+                "ctime":1618207101,
+                "desc":"倾家荡产求三连支持！！！请大家帮忙给新系列想个名字，点赞一百万的话制作三星堆黄金权杖，不会真的可以点到一百万吧\nbgm:\n-Old-B - 【Free Beat】侠之道 、于剑飞 - 01 片头曲 帝陵、AniFace - 夜辞秋江",
+                "state":0,
+                "duration":717,
+                "mission_id":16881,
+                "rights":{
+                    "bp":0,
+                    "elec":0,
+                    "download":0,
+                    "movie":0,
+                    "pay":0,
+                    "hd5":0,
+                    "no_reprint":1,
+                    "autoplay":1,
+                    "ugc_pay":0,
+                    "is_cooperation":0,
+                    "ugc_pay_preview":0,
+                    "no_background":0,
+                    "arc_pay":0,
+                    "pay_free_watch":0
+                },
+                "owner":{
+                    "mid":2200736,
+                    "name":"才疏学浅的才浅",
+                    "face":"http://i2.hdslb.com/bfs/face/1f4819b224cd882025a9a6a5f2c6680c332f37bc.jpg"
+                },
+                "stat":{
+                    "aid":715024588,
+                    "view":13833908,
+                    "danmaku":215105,
+                    "reply":39792,
+                    "favorite":619513,
+                    "coin":2484204,
+                    "share":122302,
+                    "now_rank":0,
+                    "his_rank":1,
+                    "like":2338710,
+                    "dislike":0
+                },
+                "dynamic":"倾家荡产求三连！！",
+                "cid":323723441,
+                "dimension":{
+                    "width":1920,
+                    "height":1080,
+                    "rotate":0
+                },
+                "season_id":19992,
+                "short_link":"https://b23.tv/BV16X4y1g7wT",
+                "short_link_v2":"https://b23.tv/BV16X4y1g7wT",
+                "bvid":"BV16X4y1g7wT",
+                "season_type":0,
+                "is_ogv":false,
+                "ogv_info":null,
+                "rcmd_reason":"",
+                "achievement":"央视新华社点赞，博物馆喊话来上班！"
+            }, 
+            ... and more
+        ]
+    }
+}
+```
+</details>