返回提交历史
Modified
message/private_msg.md
+124
-1
XFEstudio/bilibili-API-collect
新增发送私信部分
up有时间改写一下 示例部分，不知道curl该怎么写
487768c
代码差异
1 个文件
+124
-1
@@ -21,7 +21,7 @@
21
21
| ttl | num | 1 | 作用尚不明确 |
22
22
| data | obj | 信息本体 | |
23
23
24
data 对象：
24
`data` 对象：
25
25
26
26
| 字段 | 类型 | 内容 | 备注 |
27
27
| --------------- | ---- | -------------------- | ------------ |
@@ -51,3 +51,126 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
51
51
}
52
52
```
53
53
54
55
56
## 发送私信
57
58
> http://api.vc.bilibili.com/web_im/v1/web_im/send_msg
59
60
*请求方式：POST*
61
62
认证方式：Cookie（SESSDATA）
63
64
**正文参数（application/x-www-form-urlencoded）**
65
66
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
67
| ------------------ | ---------- | --------- | ------ | -------------------------------------- |
68
| msg[sender_uid] | num | 发送者uid | 必要 | |
69
| msg[receiver_id] | num | 接收者uid | 必要 | |
70
| msg[receiver_type] | num | 1 | 必要 | |
71
| msg[msg_type] | num | | 必要 | 1:发送文字<br>2:发送图片<br>5:撤回消息 |
72
| msg[msg_status] | num | 0 | 非必要 | |
73
| msg[content] | obj \| num | 私信内容 | 必要 | 撤回消息时为num |
74
| csrf_token | str | | 必要 | 登录后的bili_jct |
75
76
`msg[content]`对象（发送文字）：
77
78
| 字段 | 类型 | 内容 | 备注 |
79
| ------- | ---- | -------- | ---- |
80
| content | str | 私信内容 | |
81
82
83
84
`msg[content]`对象（发送图片）：
85
86
| 字段 | 类型 | 内容 | 必要性 | 备注 |
87
| -------- | ---- | ---------- | ------ | :--------------------------- |
88
| url | str | 图片的url | 必要 | 可以先上传第三方图床 |
89
| width | num | 图片的宽 | 非必要 | 单位：像素 |
90
| height | num | 图片的高 | 非必要 | 单位：像素 |
91
| type | str | 图片的类型 | 非必要 | 例如：jpeg |
92
| original | num | 1 | 非必要 | **作用未知** |
93
| size | num | 文件大小 | 非必要 | 单位：千字节<br>__向上取整__ |
94
95
96
97
<!--`msg[content]`撤回消息：msg_key-->
98
99
100
101
**json回复：**
102
103
根对象：
104
| 字段 | 类型 | 内容 | 备注 |
105
| ------- | ---- | -------- | ----------- |
106
| code | num | 返回值 | 0：成功<br> |
107
| message | str | 错误信息 | 默认为ok |
108
| msg | str | 错误信息 | 默认为ok |
109
| data | obj | 主体 | 出错时为空 |
110
111
`data`对象：
112
113
| 字段 | 类型 | 内容 | 备注 |
114
| ------- | ---- | ---- | ------------ |
115
| msg_key | num | | 作用尚不明确 |
116
| \_gt\_ | num | 0 | 作用尚不明确 |
117
118
**示例：**
119
120
给B站用户`-1`发一条文字私信：
121
122
> up主你好，
123
>
124
> 催更
125
126
```shell
127
正文参数：
128
msg[sender_uid] = 你的uid
129
msg[receiver_id] = -1
130
msg[receiver_type] = 1
131
msg[msg_type] = 1
132
msg[content] = {"content": "up主你好，\n催更[doge]"}
133
csrf_token = 登录后的bili_jct
134
cookies:
135
SESSDATA = 登录后的SESSDATA
136
```
137
138
```json
139
{
140
"code":0,
141
"msg":"ok",
142
"message":"ok",
143
"data":{
144
"msg_key":6852559688104417870,"_gt_":0
145
}
146
}
147
```
148
149
给B站用户`-1`发一条图片私信：
150
151
> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" >
152
153
```shell
154
正文参数：
155
msg[sender_uid] = 你的uid
156
msg[receiver_id] = -1
157
msg[receiver_type] = 1
158
msg[msg_type] = 2
159
msg[content] = {"url": "https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"}
160
csrf_token = 登录后的bili_jct
161
cookies:
162
SESSDATA = 登录后的SESSDATA
163
```
164
165
```json
166
{
167
"code":0,
168
"msg":"ok",
169
"message":"ok",
170
"data":{
171
"msg_key":6852570013146024354,
172
"_gt_":0
173
}
174
}
175
```
176