返回提交历史
Added
user/contract.md
+131
-0
Modified
user/info.md
+46
-38
XFEstudio/bilibili-API-collect
添加老粉计划 (#537)
* 添加老粉计划 * 添加老粉计划 * 修改格式
c723ff9
代码差异
2 个文件
+177
-38
@@ -0,0 +1,131 @@
1
# 加入老粉计划
2
3
> https://api.bilibili.com/x/v1/contract/add_contract
4
5
*请求方式：POST*
6
7
是否需要登录：`是`
8
9
认证方式：Cookie(SESSDATA)
10
11
**正文参数 (application/x-www-form-urlencoded)：**
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
|----------|-----|--------|-----|-----|
15
| aid | str | `空串` | | |
16
| up_mid | str | UP主UID | 必要 | |
17
| source | str | `4` | | |
18
| scene | str | `105` | | |
19
| platform | str | `web` | | |
20
| mobi_app | str | `pc` | | |
21
| csrf | str | 用户csrf | 必要 | |
22
23
**json回复：**
24
25
根对象：
26
27
| 字段名 | 类型 | 内容 | 备注 |
28
|---------|-----|------|-------------------------|
29
| code | num | 响应码 | 0：成功<br/>158001：`不满足条件` |
30
| message | str | 0 | |
31
| ttl | num | 1 | |
32
| data | obj | 信息本体 | |
33
34
`data`对象
35
36
| 字段名 | 类型 | 内容 | 备注 |
37
|---------------|------|-----------------------------------|-----|
38
| allow_message | bool | `true` | |
39
| input_text | str | `UP主加油！看好你噢` | |
40
| input_title | str | `感谢你对UP主的特别支持，“老粉”可期！私信留言鼓励下TA吧 ` | |
41
42
**示例：**
43
44
```shell
45
curl --location --request POST 'https://api.bilibili.com/x/v1/contract/add_contract' \
46
--header 'Cookie: SESSDATA=xxx' \
47
--header 'Content-Type: application/x-www-form-urlencoded' \
48
--data-urlencode 'up_mid=2' \
49
--data-urlencode 'csrf=xxx'
50
```
51
52
<details>
53
<summary>点击查看</summary>
54
55
```json
56
{
57
"code": 0,
58
"message": "0",
59
"ttl": 1,
60
"data": {
61
"allow_message": true,
62
"input_text": "UP主加油！看好你噢",
63
"input_title": "感谢你对UP主的特别支持，“老粉”可期！私信留言鼓励下TA吧 "
64
}
65
}
66
```
67
68
</details>
69
70
# 老粉计划发送留言
71
72
> https://api.bilibili.com/x/v1/contract/add_message
73
74
*请求方式：POST*
75
76
认证方式：Cookie (SESSDATA)
77
78
**正文参数 (application/x-www-form-urlencoded)：**
79
80
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
81
|---------|-----|--------|-----|-----|
82
| aid | str | `空串` | | |
83
| up_mid | str | UP主UID | 必要 | |
84
| source | str | `4` | | |
85
| scene | str | `105` | | |
86
| content | str | 留言内容 | 必要 | |
87
| csrf | str | 用户csrf | 必要 | |
88
89
**json回复：**
90
91
根对象：
92
93
| 字段名 | 类型 | 内容 | 备注 |
94
|---------|-----|------|------------------------------|
95
| code | num | 响应码 | 0：成功<br/>158005：您跟up主还不是契约关系 |
96
| message | str | 0 | |
97
| ttl | num | 1 | |
98
| data | obj | 信息本体 | |
99
100
`data`对象
101
102
| 字段名 | 类型 | 内容 | 备注 |
103
|---------------|-----|------------------|-----|
104
| success_toast | str | `提交成功，UP主已收到留言~` | |
105
106
**示例：**
107
108
```shell
109
curl --location --request POST 'https://api.bilibili.com/x/v1/contract/add_message' \
110
--header 'Cookie: SESSDATA=xxx' \
111
--header 'Content-Type: application/x-www-form-urlencoded' \
112
--data-urlencode 'up_mid=2' \
113
--data-urlencode 'content=..' \
114
--data-urlencode 'csrf=xxx'
115
```
116
117
<details>
118
<summary>点击查看</summary>
119
120
```json
121
{
122
"code": 0,
123
"message": "0",
124
"ttl": 1,
125
"data": {
126
"success_toast": "提交成功，UP主已收到留言~"
127
}
128
}
129
```
130
131
</details>
@@ -36,44 +36,45 @@
36
36
37
37
`data`对象：
38
38
39
| 字段 | 类型 | 内容 | 备注 |
40
|------------------|------|------------|---------------------------------------------------------------|
41
| mid | num | mid | |
42
| name | str | 昵称 | |
43
| sex | str | 性别 | 男/女/保密 |
44
| face | str | 头像链接 | |
45
| face_nft | num | 是否为 nft 头像 | `0`不是nft头像<br />`1`是 nft 头像 |
46
| face_nft_type | num | | 0,1 |
47
| sign | str | 签名 | |
48
| rank | num | 用户权限等级 | 目前应该无任何作用<br/>5000：0级未答题<br/>10000：普通会员<br/>20000：字幕君<br/>25000：VIP<br/>30000：真·职人<br/>32000：管理员 |
49
| level | num | 当前等级 | 0-6级 |
50
| jointime | num | 注册时间 | 此接口返回恒为`0` |
51
| moral | num | 节操值 | 此接口返回恒为`0` |
52
| silence | num | 封禁状态 | 0：正常<br />1：被封 |
53
| coins | num | 硬币数 | 需要登录(Cookie) <br />只能查看自己的<br />默认为0 |
54
| fans_badge | bool | 是否具有粉丝勋章 | false：无<br />true：有 |
55
| fans_medal | obj | 粉丝勋章信息 | |
56
| official | obj | 认证信息 | |
57
| vip | obj | 会员信息 | |
58
| pendant | obj | 头像框信息 | |
59
| nameplate | obj | 勋章信息 | |
60
| user_honour_info | obj | | |
61
| is_followed | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录恒为false |
62
| top_photo | str | 主页头图链接 | |
63
| theme | obj | 空 | **作用尚不明确** |
64
| sys_notice | obj | 系统通知 | 无内容则为空对象<br />主要用于展示如用户争议、纪念账号等等 |
65
| live_room | obj | 直播间信息 | |
66
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
67
| school | obj | 学校 | |
68
| profession | obj | 专业资质信息 | |
69
| tags | null | 个人标签 | |
70
| series | obj | | |
71
| is_senior_member | num | 是否为硬核会员 | 0：否<br />1：是 |
72
| mcn_info | null | | |
73
| gaia_res_type | num | | |
74
| gaia_data | null | | |
75
| is_risk | bool | | |
76
| elec | obj | 充电信息 | |
39
| 字段 | 类型 | 内容 | 备注 |
40
|------------------|------|------------|--------------------------------------------------------------------------------------------------|
41
| mid | num | mid | |
42
| name | str | 昵称 | |
43
| sex | str | 性别 | 男/女/保密 |
44
| face | str | 头像链接 | |
45
| face_nft | num | 是否为 nft 头像 | `0`不是nft头像<br />`1`是 nft 头像 |
46
| face_nft_type | num | | 0,1 |
47
| sign | str | 签名 | |
48
| rank | num | 用户权限等级 | 目前应该无任何作用<br/>5000：0级未答题<br/>10000：普通会员<br/>20000：字幕君<br/>25000：VIP<br/>30000：真·职人<br/>32000：管理员 |
49
| level | num | 当前等级 | 0-6级 |
50
| jointime | num | 注册时间 | 此接口返回恒为`0` |
51
| moral | num | 节操值 | 此接口返回恒为`0` |
52
| silence | num | 封禁状态 | 0：正常<br />1：被封 |
53
| coins | num | 硬币数 | 需要登录(Cookie) <br />只能查看自己的<br />默认为0 |
54
| fans_badge | bool | 是否具有粉丝勋章 | false：无<br />true：有 |
55
| fans_medal | obj | 粉丝勋章信息 | |
56
| official | obj | 认证信息 | |
57
| vip | obj | 会员信息 | |
58
| pendant | obj | 头像框信息 | |
59
| nameplate | obj | 勋章信息 | |
60
| user_honour_info | obj | | |
61
| is_followed | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录恒为false |
62
| top_photo | str | 主页头图链接 | |
63
| theme | obj | 空 | **作用尚不明确** |
64
| sys_notice | obj | 系统通知 | 无内容则为空对象<br />主要用于展示如用户争议、纪念账号等等 |
65
| live_room | obj | 直播间信息 | |
66
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
67
| school | obj | 学校 | |
68
| profession | obj | 专业资质信息 | |
69
| tags | null | 个人标签 | |
70
| series | obj | | |
71
| is_senior_member | num | 是否为硬核会员 | 0：否<br />1：是 |
72
| mcn_info | null | | |
73
| gaia_res_type | num | | |
74
| gaia_data | null | | |
75
| is_risk | bool | | |
76
| elec | obj | 充电信息 | |
77
| contract | obj | 是否显示老粉计划 | |
77
78
78
79
`rank`示例
79
80
@@ -311,6 +312,13 @@
311
312
| icon | str | `空串` | |
312
313
| jump_url | str | `空串` | |
313
314
315
`data`中的`contract`对象：
316
317
| 字段名 | 类型 | 内容 | 备注 |
318
|-------------------|------|-----------|---------------------------|
319
| is_display | bool | | true/false<br/>在页面中未使用此字段 |
320
| is_follow_display | bool | 是否在显示老粉计划 | true：显示<br/>false：不显示 |
321
314
322
**示例：**
315
323
316
324
查询用户`mid=2`的详细信息