diff --git a/message/private_msg.md b/message/private_msg.md index 85448be1b8..d13238e70f 100644 --- a/message/private_msg.md +++ b/message/private_msg.md @@ -21,7 +21,7 @@ | ttl | num | 1 | 作用尚不明确 | | data | obj | 信息本体 | | -data 对象: +`data` 对象: | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | -------------------- | ------------ | @@ -51,3 +51,127 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\ } ``` + + +## 发送私信 + +> 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:发送文字
2:发送图片
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 | 文件大小 | 非必要 | 单位:千字节
__向上取整__ | + + + + + + + +**json回复:** + +根对象: +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------- | +| code | num | 返回值 | 0:成功
| +| message | str | 错误信息 | 默认为ok | +| msg | str | 错误信息 | 默认为ok | +| data | obj | 主体 | 出错时为空 | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ---- | ------------ | +| msg_key | num | | 作用尚不明确 | +| \_gt\_ | num | 0 | 作用尚不明确 | + +**示例:** + +给B站用户`-1`发一条文字私信: + +> up主你好, +> +> 催更![doge](https://s1.ax1x.com/2020/07/23/ULJEfU.png) + +```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`发一条图片私信: + +> + +```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 + } +} +``` +