Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: 添加消息中心接口相关说明 #983

Draft
wants to merge 54 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from 45 commits
Commits
Show all changes
54 commits
Select commit Hold shift + click to select a range
551965a
Update charge_list.md
wuziqian211 Feb 26, 2023
f599147
Update charge_msg.md
wuziqian211 Feb 26, 2023
2871403
Update relation.md
wuziqian211 Feb 26, 2023
b2a1d78
Update relation.md
wuziqian211 Feb 26, 2023
e4e930d
update
wuziqian211 Feb 26, 2023
1606c2d
Update monthly.md
wuziqian211 Feb 26, 2023
a61928e
Update monthly.md
wuziqian211 Feb 26, 2023
7a04a16
update
wuziqian211 Feb 26, 2023
4140374
Update charge_list.md
wuziqian211 Feb 27, 2023
0f896dd
Merge branch 'SocialSisterYi:master' into patch-1
wuziqian211 Feb 27, 2023
c5de8db
Merge branch 'patch-1' of https://github.com/wuziqian211/bilibili-API…
wuziqian211 Feb 27, 2023
b7f78a7
Update relation.md
wuziqian211 Feb 27, 2023
3e39619
Merge branch 'SocialSisterYi:master' into patch-1
wuziqian211 Mar 8, 2023
c7400ff
Update monthly.md
wuziqian211 Mar 9, 2023
919cd2d
Update README.md
wuziqian211 Mar 9, 2023
d730a5b
Update charge_list.md
wuziqian211 Mar 9, 2023
7b6f581
update
wuziqian211 Mar 12, 2023
fa1a87a
Update relation.md
wuziqian211 Mar 12, 2023
f33e9f0
Update relation.md
wuziqian211 Mar 12, 2023
9459e2d
Update relation.md
wuziqian211 Mar 15, 2023
f896727
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Mar 10, 2024
83a1a4e
Update info.md
wuziqian211 Mar 10, 2024
9957f0c
update
wuziqian211 Mar 10, 2024
d04d419
update
wuziqian211 Mar 12, 2024
0a92be0
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Mar 12, 2024
6518135
rename
wuziqian211 Mar 12, 2024
b3d6d18
update docs
wuziqian211 Mar 13, 2024
b6fb3b5
update
wuziqian211 Mar 13, 2024
e6072a6
update
wuziqian211 Mar 14, 2024
3f0bc38
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Mar 15, 2024
b8da0e5
update
wuziqian211 Mar 15, 2024
f1c53f9
update
wuziqian211 Mar 28, 2024
444fc8a
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Mar 28, 2024
8539abd
add more docs
wuziqian211 Mar 31, 2024
fc60fd4
update docs
wuziqian211 Apr 6, 2024
cc83d30
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Apr 6, 2024
81de2eb
更新 private_msg.md
wuziqian211 Apr 6, 2024
0ce0d4d
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Apr 10, 2024
e911d09
Update Layout.vue
wuziqian211 Apr 12, 2024
cddc8fa
Update README.md
wuziqian211 Apr 12, 2024
a262798
Merge pull request #1 from wuziqian211/patch-2
wuziqian211 Apr 12, 2024
b27143a
添加 #1008 相关说明
wuziqian211 Apr 21, 2024
d4bd404
Merge branch 'patch-1' of https://github.com/wuziqian211/bilibili-API…
wuziqian211 Apr 21, 2024
5e4ad07
Update README.md
wuziqian211 Apr 21, 2024
392dc2b
Update CONTRIBUTING.md
wuziqian211 May 3, 2024
6521e3f
Update CONTRIBUTING.md
wuziqian211 May 3, 2024
58c7650
Update private_msg.md
wuziqian211 May 3, 2024
d50666c
fix: typo
wuziqian211 May 3, 2024
2c9960f
update docs
wuziqian211 May 28, 2024
86ef2ee
feat: #1033
wuziqian211 Jun 10, 2024
6dfeff4
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Jun 10, 2024
9b80590
update docs
wuziqian211 Jun 17, 2024
b743ebe
Merge remote-tracking branch 'upstream/master' into patch-1
wuziqian211 Jun 17, 2024
ba78a78
fix: typo
wuziqian211 Jun 17, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
2 changes: 1 addition & 1 deletion .vuepress/theme/layouts/Layout.vue
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<ParentLayout>
<template #page-bottom>
<footer style="text-align: center">
Copyright © 2020-2023
Copyright © 2020-2024
<a href="https://github.com/SocialSisterYi/">SocialSisterYi</a> |
<a
href="https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/LICENSE"
Expand Down
102 changes: 51 additions & 51 deletions CONTRIBUTING.md

Large diffs are not rendered by default.

112 changes: 53 additions & 59 deletions README.md

Large diffs are not rendered by default.

4 changes: 4 additions & 0 deletions docs/history&toview/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@

注:`max`、`business`、`view_at`参数用于历史记录列表的 IFS (无限滚动),其用法类似链表的 next 指针

本接口也可以返回已失效稿件的信息

**url参数:**

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
Expand Down Expand Up @@ -349,6 +351,8 @@ curl -G 'https://api.bilibili.com/x/web-interface/history/cursor' \

认证方式:Cookie (SESSDATA)

本接口也可以返回已失效稿件的信息

**url参数:**

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
Expand Down
4 changes: 3 additions & 1 deletion docs/message/msg.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@

认证方式:Cookie(SESSDATA)

本接口不会返回未读的私信数,要获取未读的私信数请参阅[未读私信数](private_msg.md#未读私信数)相关说明

**json回复:**

根对象:
Expand All @@ -19,7 +21,7 @@
| ttl | num | 1 | |
| data | obj | 信息本体 | |

data 对象:
`data` 对象:

| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------------- | ------------ |
Expand Down
898 changes: 696 additions & 202 deletions docs/message/private_msg.md

Large diffs are not rendered by default.

572 changes: 572 additions & 0 deletions docs/message/private_msg_content.md

Large diffs are not rendered by default.

28 changes: 12 additions & 16 deletions docs/user/info.md
Original file line number Diff line number Diff line change
Expand Up @@ -939,12 +939,12 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \

认证方式:Cookie(SESSDATA)

本接口较其他接口相比,只会返回非常有限的信息,但可以同时获取较多的用户信息(据测试可以同时获取 40000 多个用户的信息)
本接口较其他接口相比,只会返回非常有限的信息,但可以同时获取较多的用户信息(据测试可以一次性获取 40000 多个用户的信息)

**url参数:**

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | --------------------------------- |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | ------------------- |
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 |

**json回复:**
Expand All @@ -954,8 +954,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------- |
| code | num | 返回值 | 0:成功<br />-400:请求错误 |
| msg | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 信息本体 | 用户信息随机排序 |

`data`数组:
Expand All @@ -972,7 +972,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
| ------- | ---- | ------------ | -------------------- |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 用户权限等级 | |
Expand All @@ -995,34 +994,31 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
```json
{
"code": 0,
"msg": "",
"message": "",
"ttl": 1,
"data": [{
"mid": 1,
"name": "bishi",
"sex": "男",
"face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"sign": "",
"rank": 10000,
"level": 4,
"level": 6,
"silence": 0
}, {
"mid": 2,
"name": "碧诗",
"sex": "男",
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
"rank": 20000,
"level": 6,
"silence": 0
}, {
"mid": 3,
"name": "囧囧倉",
"sex": "男",
"face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
"rank": 10000,
"level": 5,
"level": 6,
"silence": 0
}]
}
Expand Down
30 changes: 14 additions & 16 deletions docs/user/relation.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | -------------------------- | ------------------------------------------------------------ |
| mid | num | 用户 mid | |
| attribute | num | 对方对于**自己**的关系属性 | 0:未关注<br />1:悄悄关注(现已下线)<br />2:已关注<br />6:已互粉<br />128:已拉黑 |
| attribute | num | 对方对于**自己**的关系属性 | 0:未关注<br />~~1:悄悄关注(现已下线)~~<br />2:已关注<br />6:已互粉<br />128:已拉黑 |
| mtime | num | 对方关注目标用户时间 | 秒级时间戳<br />互关后刷新 |
| tag | 默认分组:null<br />存在至少一个分组:array | 目标用户将对方分组到的 id | |
| special | num | 目标用户特别关注对方标识 | 0:否<br />1:是 |
Expand Down Expand Up @@ -97,7 +97,7 @@

| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-352:请求被拦截<br />-400:请求错误<br />22007:访问超过 5 页 |
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-352:请求被拦截<br />-400:请求错误<br />22118:由于该用户隐私设置,粉丝列表不可见 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
Expand Down Expand Up @@ -368,7 +368,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \

| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------------------------------- |
| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构不同 |
| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构**不同** |
| n | obj | 关注(n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |

Expand Down Expand Up @@ -501,9 +501,7 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \

</details>

## 查询用户关注明细3

<img src="../../assets/img/relation.svg" width="100" height="100" />
### 查询用户关注明细3

> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list

Expand Down Expand Up @@ -1289,23 +1287,23 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \

操作代码`act`:

| 代码 | 含义 |
| ---- | ------------ |
| 1 | 关注 |
| 2 | 取关 |
| 3 | 悄悄关注 |
| 4 | 取消悄悄关注 |
| 5 | 拉黑 |
| 6 | 取消拉黑 |
| 7 | 踢出粉丝 |
| 代码 | 含义 | 备注 |
| ---- | ------------ | ------------------------------------------------ |
| 1 | 关注 | 无法对已注销或不存在的用户进行此操作 |
| 2 | 取关 | |
| 3 | 悄悄关注 | 现已下线,使用本操作代码请求接口会提示“请求错误” |
| 4 | 取消悄悄关注 | |
| 5 | 拉黑 | 无法对已注销或不存在的用户进行此操作 |
| 6 | 取消拉黑 | |
| 7 | 踢出粉丝 | |

**json回复:**

根对象:

| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-102:账号被封停<br />-111:csrf校验失败<br />-400:请求错误<br />22001:不能对自己进行此操作<br />22003:用户位于黑名单 |
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-102:账号被封停<br />-111:csrf校验失败<br />-400:请求错误<br />22001:不能对自己进行此操作<br />22002:因对方隐私设置,你还不能关注<br />22003:关注失败,请将该用户移除黑名单之后再试<br />22013:账号已注销,无法完成操作<br />22014:已经关注用户,无法重复关注<br />22120:重复加入黑名单<br />40061:用户不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |

Expand Down