修改发送私信

This commit is contained in:
SocialSisterYi 2020-07-27 23:49:37 +08:00
parent 1b653d9165
commit 608479ae8d

View File

@ -18,16 +18,16 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-6账号未登录 |
| message | str | 错误信息 | 默认为ok |
| ttl | num | 1 | 作用尚不明确 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------------- | ------------ |
| unfollow_unread | num | 未关注用户未读私信数 | |
| follow_unread | num | 已关注用户未读私信数 | |
| _gt_ | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------------- | ---- |
| unfollow_unread | num | 未关注用户未读私信数 | |
| follow_unread | num | 已关注用户未读私信数 | |
| _gt_ | num | 0 | |
**示例:**
@ -51,9 +51,7 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
}
```
## 发送私信
## 发送私信web端
> http://api.vc.bilibili.com/web_im/v1/web_im/send_msg
@ -61,42 +59,48 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
认证方式CookieSESSDATA
**正文参数application/x-www-form-urlencoded**
**正文参数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[sender_uid] | num | 发送者UID | 必要 | |
| msg[receiver_id] | num | 接收者UID | 必要 | |
| msg[receiver_type] | num | 1 | 必要 | 固定为1 |
| msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字<br>2:发送图片<br>5:撤回消息 |
| msg[msg_status] | num | 0 | 非必要 | |
| msg[content] | 发送文字时str<br />撤回消息时num | 消息内容 | 必要 | **详见下表** |
| csrf_token | str | CSRF Token位于cookie | 必要 | |
`msg[content]`对象(发送文字):
`msg[content]`消息内容:
当发送文字时(`msg[msg_type]=1`
该参数为json序列字串
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- |
| content | str | 私信内容 | |
当发送图片时(`msg[msg_type]=2`
该参数为json序列字串
`msg[content]`对象(发送图片)
根对象
| 字段 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------- | ------ | :--------------------------- |
| url | str | 图片的url | 必要 | 可以先上传第三方图床 |
| width | num | 图片的宽 | 非必要 | 单位:像素 |
| height | num | 图片的高 | 非必要 | 单位:像素 |
| type | str | 图片的类型 | 非必要 | 例如jpeg |
| original | num | 1 | 非必要 | **作用未知** |
| size | num | 文件大小 | 非必要 | 单位:千字节<br>__向上取整__ |
<!--`msg[content]`撤回消息msg_key-->
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | :-------------------------------------------- |
| url | str | 图片url | 默认为B站相簿图片上传通道<br />也可用三方图床 |
| width | num | 图片的宽 | 单位:像素(非必要) |
| height | num | 图片的高 | 单位:像素(非必要) |
| type | str | 图片格式 | (非必要) |
| original | num | 1 | **作用未知**(非必要) |
| size | num | 文件大小 | 单位:千字节(非必要)<br>__向上取整__ |
当撤回消息时(`msg[msg_type]=5`
该参数为数值,为目标消息的` msg_key `
**json回复**
@ -117,22 +121,21 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
**示例:**
B站用户`-1`发一条文字私信:
目标用户`UID=1`发一条文字私信:
> up主你好
>
> 催更![doge](https://s1.ax1x.com/2020/07/23/ULJEfU.png)
> 催更[doge]
```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
curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg'\
--data-urlencode 'msg[sender_uid]=293793435'\
--data-urlencode 'msg[receiver_id]=1'\
--data-urlencode 'msg[receiver_type] =1'\
--data-urlencode 'msg[msg_type]=1'\
--data-urlencode 'msg[content]={"content":"up主你好\n催更[doge]"}'\
--data-urlencode 'csrf_token=xxx'\
-b 'SESSDATA=xxx'
```
```json
@ -147,20 +150,19 @@ cookies:
}
```
B站用户`-1`发一条图片私信:
目标用户`UID=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
curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg'\
--data-urlencode 'msg[sender_uid]=293793435'\
--data-urlencode 'msg[receiver_id]=1'\
--data-urlencode 'msg[receiver_type] =1'\
--data-urlencode 'msg[msg_type]=2'\
--data-urlencode 'msg[content]={"url":https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg}'\
--data-urlencode 'csrf_token=xxx'\
-b 'SESSDATA=xxx'
```
```json