From baad55d2af71a1658d0f3d20436860d5134cc472 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: Mon, 8 Jun 2020 23:48:35 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=B8=93=E6=A0=8F=E7=82=B9?= =?UTF-8?q?=E8=B5=9E=E6=8A=95=E5=B8=81=E6=94=B6=E8=97=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 +- article/like_coin_fav.md | 137 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 139 insertions(+), 2 deletions(-) create mode 100644 article/like_coin_fav.md diff --git a/README.md b/README.md index 7700f64..47c18dc 100644 --- a/README.md +++ b/README.md @@ -65,7 +65,7 @@ - [弹幕操作](danmaku/action.md)× - [专栏](article) - [基本信息](article/info.md)× - - 点赞&投币&收藏 + - [点赞&投币&收藏](article/like_coin_fav.md)× - 文集基本信息 - [音频](music) - [歌曲基本信息](music/info.md)√ @@ -131,7 +131,7 @@ - 哔哩哔哩漫画 - 哔哩哔哩游戏 - [其他](other) - - [ip位置查询](other/ip.md)√ + - [基于ip的地理位置查询](other/ip.md)√ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列,欢迎关注 diff --git a/article/like_coin_fav.md b/article/like_coin_fav.md new file mode 100644 index 0000000..3f64a56 --- /dev/null +++ b/article/like_coin_fav.md @@ -0,0 +1,137 @@ +# 专栏投币&点赞&收藏 + +**本页所有操作均需登录(SESSDATA)** + +## 点赞文章 + + + +> http://api.bilibili.com/x/article/like + +*方式:POST* + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------- | ------ | ---------------------- | +| id | num | 文章cvID | 必要 | | +| type | num | 操作方式 | 必要 | 1:点赞
2:取消赞 | +| csrf | str | cookies中的bili_jct | 必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
10003:不存在该稿件
65006:已赞过
65004:取消点赞失败 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | + +**示例:** + +为文章`cv5806746`点赞 + +curl -b "SESSDATA=xxx" -d "id=5806746&type=1&csrf=xxx" "http://api.bilibili.com/x/article/like" + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + + + +## 投币文章 + + + +> http://api.bilibili.com/x/web-interface/coin/add + +*方式:POST* + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| -------- | ---- | ------------------- | ------ | ------- | +| aid | num | 文章cvID | 必要 | | +| multiply | num | 投币数量 | 必要 | 上限为2 | +| csrf | str | cookies中的bili_jct | 必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-102:账号被封停
-104:硬币不足
-111:csrf校验失败
-400:请求错误
10003:不存在该稿件
34002:不能给自己投币
34003:非法的投币数量
34005:超过投币上限 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +data 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ----------------------------------------------------- | +| like | bool | 是否点赞成功 | true:成功
false:失败
已赞过则附加点赞失败 | + +**示例:** + +为文章`cv5806746`投币1枚 + +curl -b "SESSDATA=xxx" -d "aid=5806746&multiply=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/coin/add" + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "like": false + } +} +``` + + + +## 收藏文章 + + + +>http://api.bilibili.com/x/article/favorites/add + +*方式:POST* + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------- | ------ | ---- | +| id | num | 文章cvID | 必要 | | +| csrf | str | cookies中的bili_jct | 必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
-404:无此项 | +| message | str | 错误信息 | 正确为success | +| data | obj | 信息本体 | | + +**示例:** + +收藏文章`cv5806746` + +curl -b "SESSDATA=xxx" -d "id=5806746&csrf=xxx" "http://api.bilibili.com/x/article/favorites/add" + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` +