mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-02-01 06:40:08 +08:00
177 lines
5.0 KiB
Markdown
177 lines
5.0 KiB
Markdown
# 私信
|
||
|
||
**本页所有操作均需登录（SESSDATA）**
|
||
|
||
## 未读私信数
|
||
|
||
> http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread
|
||
|
||
*请求方式：GET*
|
||
|
||
认证方式：Cookie（SESSDATA）
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | --------------------------- |
|
||
| code | num | 返回值 | 0：成功<br />-6：账号未登录 |
|
||
| message | str | 错误信息 | 默认为ok |
|
||
| ttl | num | 1 | 作用尚不明确 |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data` 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| --------------- | ---- | -------------------- | ------------ |
|
||
| unfollow_unread | num | 未关注用户未读私信数 | |
|
||
| follow_unread | num | 已关注用户未读私信数 | |
|
||
| _gt_ | num | 0 | 作用尚不明确 |
|
||
|
||
**示例：**
|
||
|
||
以下信息代表了为未关注用户未读私信数为`10`条，已关注用户未读私信数为`3`条
|
||
|
||
```shell
|
||
curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
|
||
-b 'SESSDATA=xxx'
|
||
```
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "ok",
|
||
"message": "ok",
|
||
"data": {
|
||
"unfollow_unread": 1,
|
||
"follow_unread": 6,
|
||
"_gt_": 0
|
||
}
|
||
}
|
||
```
|
||
|
||
|
||
|
||
## 发送私信
|
||
|
||
> http://api.vc.bilibili.com/web_im/v1/web_im/send_msg
|
||
|
||
*请求方式：POST*
|
||
|
||
认证方式：Cookie（SESSDATA）
|
||
|
||
**正文参数（application/x-www-form-urlencoded）**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ------------------ | ---------- | --------- | ------ | -------------------------------------- |
|
||
| msg[sender_uid] | num | 发送者uid | 必要 | |
|
||
| msg[receiver_id] | num | 接收者uid | 必要 | |
|
||
| msg[receiver_type] | num | 1 | 必要 | |
|
||
| msg[msg_type] | num | | 必要 | 1:发送文字<br>2:发送图片<br>5:撤回消息 |
|
||
| msg[msg_status] | num | 0 | 非必要 | |
|
||
| msg[content] | obj \| num | 私信内容 | 必要 | 撤回消息时为num |
|
||
| csrf_token | str | | 必要 | 登录后的bili_jct |
|
||
|
||
`msg[content]`对象（发送文字）：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ---- |
|
||
| content | str | 私信内容 | |
|
||
|
||
|
||
|
||
`msg[content]`对象（发送图片）：
|
||
|
||
| 字段 | 类型 | 内容 | 必要性 | 备注 |
|
||
| -------- | ---- | ---------- | ------ | :--------------------------- |
|
||
| url | str | 图片的url | 必要 | 可以先上传第三方图床 |
|
||
| width | num | 图片的宽 | 非必要 | 单位：像素 |
|
||
| height | num | 图片的高 | 非必要 | 单位：像素 |
|
||
| type | str | 图片的类型 | 非必要 | 例如：jpeg |
|
||
| original | num | 1 | 非必要 | **作用未知** |
|
||
| size | num | 文件大小 | 非必要 | 单位：千字节<br>__向上取整__ |
|
||
|
||
|
||
|
||
<!--`msg[content]`撤回消息：msg_key-->
|
||
|
||
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ----------- |
|
||
| code | num | 返回值 | 0：成功<br> |
|
||
| message | str | 错误信息 | 默认为ok |
|
||
| msg | str | 错误信息 | 默认为ok |
|
||
| data | obj | 主体 | 出错时为空 |
|
||
|
||
`data`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | ---- | ------------ |
|
||
| msg_key | num | | 作用尚不明确 |
|
||
| \_gt\_ | num | 0 | 作用尚不明确 |
|
||
|
||
**示例：**
|
||
|
||
给B站用户`-1`发一条文字私信：
|
||
|
||
> up主你好，
|
||
>
|
||
> 催更
|
||
|
||
```shell
|
||
正文参数：
|
||
msg[sender_uid] = 你的uid
|
||
msg[receiver_id] = -1
|
||
msg[receiver_type] = 1
|
||
msg[msg_type] = 1
|
||
msg[content] = {"content": "up主你好，\n催更[doge]"}
|
||
csrf_token = 登录后的bili_jct
|
||
cookies:
|
||
SESSDATA = 登录后的SESSDATA
|
||
```
|
||
|
||
```json
|
||
{
|
||
"code":0,
|
||
"msg":"ok",
|
||
"message":"ok",
|
||
"data":{
|
||
"msg_key":6852559688104417870,"_gt_":0
|
||
}
|
||
}
|
||
```
|
||
|
||
给B站用户`-1`发一条图片私信：
|
||
|
||
> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" >
|
||
|
||
```shell
|
||
正文参数：
|
||
msg[sender_uid] = 你的uid
|
||
msg[receiver_id] = -1
|
||
msg[receiver_type] = 1
|
||
msg[msg_type] = 2
|
||
msg[content] = {"url": "https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"}
|
||
csrf_token = 登录后的bili_jct
|
||
cookies:
|
||
SESSDATA = 登录后的SESSDATA
|
||
```
|
||
|
||
```json
|
||
{
|
||
"code":0,
|
||
"msg":"ok",
|
||
"message":"ok",
|
||
"data":{
|
||
"msg_key":6852570013146024354,
|
||
"_gt_":0
|
||
}
|
||
}
|
||
```
|
||
|