添加app端的开屏图片主题颜色及个性主题的接口

2020-09-05 00:39:46 +08:00
parent c2d575543e
commit 40b60d8278
5 changed files with 677 additions and 20 deletions
--- a/APP_widget/splash.md
+++ b/APP_widget/splash.md
@@ -0,0 +1,138 @@
+# APP端开屏图片
+
+## 获取APP端开屏图片列表
+
+> http://app.bilibili.com/x/v2/splash/brand/list
+
+*请求方式：GET*
+
+鉴权方式：APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容       | 必要性      | 备注 |
+| ------ | ---- | ---------- | ----------- | ---- |
+| appkey | str  | APP密钥    | APP方式必要 |      |
+| ts     | num  | 当前时间戳 | APP方式必要 |      |
+| sign   | str  | APP签名    | APP方式必要 |      |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注                                                 |
+| ------- | ---- | -------- | ---------------------------------------------------- |
+| code    | num  | 返回值   | 0：成功<br />-3：API校验密匙错误<br />-400：请求错误 |
+| message | str  | 错误信息 | 默认为0                                              |
+| ttl     | num  | 1        |                                                      |
+| data    | obj  | 信息本体 |                                                      |
+
+`data`对象：
+
+| 字段          | 类型  | 内容         | 备注         |
+| ------------- | ----- | ------------ | ------------ |
+| pull_interval | num   | 1800         | 作用尚不明确 |
+| forcibly      | bool  | false        | 作用尚不明确 |
+| rule          | str   | order        | 作用尚不明确 |
+| list          | array | 开屏图片列表 |              |
+| show          | array | 默认显示项   |              |
+
+`data`中的`list`数组：
+
+| 项   | 类型 | 内容          | 备注 |
+| ---- | ---- | ------------- | ---- |
+| 0    | obj  | 开屏图片1     |      |
+| n    | obj  | 开屏图片(n+1) |      |
+| ……   | obj  | ……            | ……   |
+
+`list`数组中的对象：
+
+| 字段     | 类型 | 内容                  | 备注 |
+| -------- | ---- | --------------------- | ---- |
+| id       | num  | 开屏图片ID            |      |
+| thumb    | str  | 开屏图片url           |      |
+| logo_url | str  | “bilibili”logo图片url |      |
+
+`data`中的`show`数组：
+
+| 项   | 类型 | 内容       | 备注 |
+| ---- | ---- | ---------- | ---- |
+| 0    | obj  | 套了个娃？ |      |
+
+`show`数组中的对象：
+
+| 字段        | 类型 | 内容       | 备注         |
+| ----------- | ---- | ---------- | ------------ |
+| id          | num  | 开屏图片ID |              |
+| begin_time  | num  | 起始时间？ | 时间戳       |
+| end_time    | num  | 结束时间？ | 时间戳       |
+| probability | num  | 0          | 作用尚不明确 |
+| duration    | num  | 显示时间？ | 单位为毫秒   |
+
+**示例：**
+
+```shell
+curl -G 'http://app.bilibili.com/x/v2/splash/brand/list'\
+--data-urlencode 'appkey=1d8b6e7d45233436'\
+--data-urlencode 'ts=0'\
+--data-urlencode 'sign=78a89e153cd6231a4a4d55013aa063ce'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": {
+        "pull_interval": 1800,
+        "forcibly": false,
+        "rule": "order",
+        "list": [
+            {
+                "id": 10,
+                "thumb": "http://i0.hdslb.com/bfs/archive/e2d2f57e08b511d1a47203859f7bddb4ef9d4e16.png",
+                "logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
+            },
+            {
+                "id": 11,
+                "thumb": "http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png",
+                "logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
+            },
+            {
+                "id": 12,
+                "thumb": "http://i0.hdslb.com/bfs/archive/574469a4a20f41ba4dc9ecd41d15f94eea875ed9.png",
+                "logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
+            },
+            {
+                "id": 13,
+                "thumb": "http://i0.hdslb.com/bfs/archive/af0f4f611faa34340bd4f91def1973ccbfb8fbb3.png",
+                "logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
+            },
+            {
+                "id": 14,
+                "thumb": "http://i0.hdslb.com/bfs/archive/1d40e975b09d5c87b11b3ae0c9ce6c6b82f63d9e.png",
+                "logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
+            }
+        ],
+        "show": [
+            {
+                "id": 12,
+                "begin_time": 1597564800,
+                "end_time": 1630753108,
+                "probability": 0,
+                "duration": 700
+            }
+        ]
+    }
+}
+```
+
+</details>
+
+如ID=11的图片为：
+
+![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png )
+