From ab31a8b8bd8fe5c5d25f701958845323753be615 Mon Sep 17 00:00:00 2001 From: QianLin-Jiaxi <175724287+QianLin-Jiaxi@users.noreply.github.com> Date: Sun, 29 Mar 2026 20:38:21 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BA=86=E4=B8=80?= =?UTF-8?q?=E4=B8=8BAPI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/api/v1/friend.md | 29 +++++++++++++++++++++- src/api/v1/group.md | 27 ++++++++++++++++++++ src/api/v1/user.md | 59 ++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 114 insertions(+), 1 deletion(-) diff --git a/src/api/v1/friend.md b/src/api/v1/friend.md index 5ba21167..0e44a756 100644 --- a/src/api/v1/friend.md +++ b/src/api/v1/friend.md @@ -148,7 +148,7 @@ message address_book_list { repeated Data data = 2; // 列表数据 - message Data { + Data data { string list_name = 1; // 聊天对象列表名称,为"用户","我加入的群聊","机器人" repeated Data_list data = 2; @@ -274,3 +274,30 @@ POST /v1/friend/no-notify "msg": "success" // 返回消息 } ``` + +## 删除好友/邀请请求 + +POST /v1/friend/delete-request + +请求头: + +|名称|必须|备注| +|-----|-----|-----| +|token|是|无| + +请求体: + +```JSONC +{ + "id": 123 // 请求ID +} +``` + +响应体: + +```JSONC +{ + "code": 1, // 请求状态码,1为正常 + "msg": "success" // 返回消息 +} +``` \ No newline at end of file diff --git a/src/api/v1/group.md b/src/api/v1/group.md index 28f1a34b..d5223ec1 100644 --- a/src/api/v1/group.md +++ b/src/api/v1/group.md @@ -1022,3 +1022,30 @@ POST /v1/group/edit-stop-member-upload-group-file "msg": "success" // 返回状态消息 } ``` + +## 删除好友/邀请请求 + +POST /v1/friend/delete-request + +请求头: + +|名称|必须|备注| +|-----|-----|-----| +|token|是|无| + +请求体: + +```JSONC +{ + "id": 123 // 请求ID +} +``` + +响应体: + +```JSONC +{ + "code": 1, // 请求状态码,1为正常 + "msg": "success" // 返回消息 +} +``` \ No newline at end of file diff --git a/src/api/v1/user.md b/src/api/v1/user.md index 041e1ca8..100e4f08 100644 --- a/src/api/v1/user.md +++ b/src/api/v1/user.md @@ -954,3 +954,62 @@ POST /v1/user/get-user-show-adv "msg": "success" // 返回消息 } ``` + +## 设置好友备注 + +POST /v1/user/save-user-remarks + +请求头: + +| 名称 | 必须 | 备注 | +| ----- | ---- | ---- | +| token | 是 | 空 | + +请求体: + +```JSONC +{ + "friendId": "123123123", // 好友ID + "name": "测试好友备注名称", // 备注名称 + "phone": "123123123", // 备注手机号 + "others": "[{\"key\":\"123\",\"value\":\"123\"}]" // 更多备注,需将数据按照此格式转义后填入 +} +``` + +响应体: + +```JSONC +{ + "code": 1, // 请求状态码,1为正常 + "msg": "success" // 返回消息 +} +``` + +## 注销账号 + +POST /v1/user/cancel-user + +请求头: + +| 名称 | 必须 | 备注 | +| ----- | ---- | --------------- | +| token | 是 | 无 | + +请求体: + +```JSONC +{ + "phone": "123123123", // 手机号,手机号与邮箱之中只要有一个就行 + "email": "123123123@123.com", // 邮箱,手机号与邮箱之中只要有一个就行 + "captcha": "123123" // 短信/邮件验证码 +} +``` + +响应体: + +```JSONC +{ + "code": 1, // 请求状态码,1为正常 + "msg": "success" // 返回状态消息 +} +``` \ No newline at end of file From 046abed9a608dbc8a4819f0a7395fd9ecc190f79 Mon Sep 17 00:00:00 2001 From: QianLin-Jiaxi <175724287+QianLin-Jiaxi@users.noreply.github.com> Date: Sun, 29 Mar 2026 20:41:52 +0800 Subject: [PATCH 2/2] Fix data message definition in friend.md --- src/api/v1/friend.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/api/v1/friend.md b/src/api/v1/friend.md index 0e44a756..f7643dc6 100644 --- a/src/api/v1/friend.md +++ b/src/api/v1/friend.md @@ -148,7 +148,7 @@ message address_book_list { repeated Data data = 2; // 列表数据 - Data data { + message Data { string list_name = 1; // 聊天对象列表名称,为"用户","我加入的群聊","机器人" repeated Data_list data = 2; @@ -300,4 +300,4 @@ POST /v1/friend/delete-request "code": 1, // 请求状态码,1为正常 "msg": "success" // 返回消息 } -``` \ No newline at end of file +```