From 7e499eb9cdf59cb58316db82dfcd4270f4b26166 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=A4=BE=E4=BC=9A=E6=98=93=E5=A7=90QwQ?= <45892418+SocialSisterYi@users.noreply.github.com> Date: Tue, 28 Apr 2020 23:16:26 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=96=87=E7=AB=A0=E4=BF=A1?= =?UTF-8?q?=E6=81=AF=E7=9A=84api?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 10 ++-- article/info.md | 156 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 162 insertions(+), 4 deletions(-) create mode 100644 article/info.md diff --git a/README.md b/README.md index 2bdf21d..52f6f29 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,6 @@ - 密码&短信登录 - qq&微博登录 - [登录基本信息](login/login_info.md)√ - - 在线用户 - [消息](login/msg.md)x - [私信](login/private_msg.md)x - [用户](user) @@ -40,7 +39,6 @@ - [视频推荐](video/recommend.md)√ - 播放&下载地址 - 互动视频 - - 实时观看人数 - [高能进度条](video/pbp.md)√ - 番剧（影视） - 基本信息 @@ -51,8 +49,8 @@ - [历史弹幕](danmaku/history.md)√ - [快照](danmaku/snapshot.md)√ - 弹幕操作 -- 专栏 - - 基本信息 +- [专栏](article) + - [基本信息](article/info.md) - 点赞&投币&收藏 - 文集基本信息 - 音频 @@ -77,6 +75,10 @@ - [统计与数据](creativecenter/statistics&data.md)x - 列表查询相关 - 电磁力相关 +- 实时广播 + - 总则 + - 视频内广播 + - 分区实时在线 - [充电](electric) - [B币方式](electric/Bcoin.md)√ - [微信&支付宝方式](electric/WeChat&Alipay.md)√ diff --git a/article/info.md b/article/info.md new file mode 100644 index 0000000..f3beb25 --- /dev/null +++ b/article/info.md @@ -0,0 +1,156 @@ +# 专栏基本信息 + +## 获取专栏文章基本信息 + +> http://api.bilibili.com/x/article/viewinfo + +*方式：GET* + +**参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------ | ---- | +| id | url | 专栏cvID | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
-404：无此信息 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ------ | ---------------- | ------------------------------------------------------------ | +| like | num | 是否点赞 | 0：未点赞
1：已点赞
需要登录(SESSDATA)
未登录为0 | +| attention | bool | 是否关注文章作者 | false：未关注
true：已关注
需要登录(SESSDATA)
未登录为false | +| favorite | bool | 是否收藏 | false：未收藏
true：已收藏
需要登录(SESSDATA)
未登录为false | +| coin | num | 为文章投币数 | | +| stats | obj | 状态数信息 | | +| title | str | 文章标题 | | +| banner_url | str | 文章头图url | | +| mid | num | 文章作者UID | | +| author_name | str | 文章作者昵称 | | +| is_author | bool | true | 作用尚不明确 | +| image_urls | arrary | 动态封面 | | +| origin_image_urls | arrary | 封面图片 | | +| shareable | bool | true | 作用尚不明确 | +| show_later_watch | bool | true | 作用尚不明确 | +| show_small_window | bool | true | 作用尚不明确 | +| in_list | bool | 是否收于文集 | false：否
true：是 | +| pre | num | 上一篇文章cvID | 无为0 | +| next | num | 下一篇文章cvID | 无为0 | +| share_channels | arrary | 分享方式列表 | | + +`stats`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------- | ---- | +| view | num | 阅读数 | | +| favorite | num | 收藏数 | | +| like | num | 点赞数 | | +| dislike | num | 点踩数 | | +| reply | num | 评论数 | | +| share | num | 分享数 | | +| coin | num | 投币数 | | +| dynamic | num | 动态转发数 | | + +`data`中的`image_urls`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ---- | +| 0 | str | 动态封面图片url | | + +`data`中的`origin_image_urls`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ---- | +| 0 | str | 文章封面图片url | | + +`data`中的`share_channels`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | -------------- | ---- | +| 0 | obj | 分享项：qq | | +| 1 | obj | 分享项：qq空间 | | +| 2 | obj | 分享项：微信 | | +| 3 | obj | 分享项：朋友圈 | | +| 4 | obj | 分享项：微博 | | + +`data`中的`share_channels`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ----------- | ---- | +| name | str | 分享名称 | | +| picture | str | 分享图片url | | +| share_channel | str | 分享代号 | | + +**示例：** + +查询文章`cv2`的基本信息 + +http://api.bilibili.com/x/article/viewinfo?id=2 + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "like": 1, + "attention": true, + "favorite": false, + "coin": 0, + "stats": { + "view": 317712, + "favorite": 3249, + "like": 10176, + "dislike": 0, + "reply": 1333, + "share": 302, + "coin": 2002, + "dynamic": 28 + }, + "title": "专栏行为准则 ", + "banner_url": "https://i0.hdslb.com/bfs/article/131b1d41b857d5308f5bff36591d117bddc48d96.jpg@90p.webp", + "mid": 144900660, + "author_name": "专栏小天使", + "is_author": true, + "image_urls": ["https://i0.hdslb.com/bfs/article/0a72422ce8e77d8512f010d93b1b7f9bc4e64e52.jpg"], + "origin_image_urls": ["https://i0.hdslb.com/bfs/article/131b1d41b857d5308f5bff36591d117bddc48d96.jpg"], + "shareable": true, + "show_later_watch": true, + "show_small_window": true, + "in_list": false, + "pre": 115914, + "next": 38575, + "share_channels": [{ + "name": "QQ", + "picture": "https://i0.hdslb.com/bfs/album/114ccfb3a999df9c4d11f274c8c61a804c8f8803.png", + "share_channel": "QQ" + }, { + "name": "QQ空间", + "picture": "https://i0.hdslb.com/bfs/album/30e9608bbce725bca45b5910866f60ab4d5e18b3.png", + "share_channel": "QZONE" + }, { + "name": "微信", + "picture": "https://i0.hdslb.com/bfs/album/658af3c22431cd78bb7c50be3394f7c032eba12c.png", + "share_channel": "WEIXIN" + }, { + "name": "朋友圈", + "picture": "https://i0.hdslb.com/bfs/album/c1ebcec8c5302f29f792d15f04e0d6dcef53ec27.png", + "share_channel": "WEIXIN_MONMENT" + }, { + "name": "微博", + "picture": "https://i0.hdslb.com/bfs/album/3707fc23f7d3e24022712320284b0de9aa78c87d.png", + "share_channel": "SINA" + }] + } +} +``` +