From cfa30e270b13be276bfc8ee1cbdf6a2e33e20b85 Mon Sep 17 00:00:00 2001 From: "DESKTOP-L8OUL9F\\gfl0034" <1003614916@qq.com> Date: Sun, 18 Oct 2026 22:06:13 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=86=99=E6=98=8E=E4=BA=92=E5=85=B3?= =?UTF-8?q?=E5=90=8E=E5=8F=96=E5=85=B3=E4=BC=9A=E5=88=A0=E9=99=A4=E5=8F=8C?= =?UTF-8?q?=E6=96=B9=E5=A5=BD=E5=8F=8B=E8=BE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 单关不加好友,互关才成为好友,取关不是只删一方。 Co-authored-by: Cursor --- internal/transport/http/docs/openapi.yaml | 50 ----------------------- 1 file changed, 50 deletions(-) diff --git a/internal/transport/http/docs/openapi.yaml b/internal/transport/http/docs/openapi.yaml index 28587de..8a378a6 100644 --- a/internal/transport/http/docs/openapi.yaml +++ b/internal/transport/http/docs/openapi.yaml @@ -1278,56 +1278,6 @@ paths: application/json: schema: $ref: "#/components/schemas/Envelope" - /v1/follows/{uid}: - get: - tags: [friends] - summary: 查看关注状态 - description: | - 当前用户是否关注对方。无请求体。`data` 含 `uid`、`following`、`followed_by`、`mutual`、`friend`。 - 这是关注关系,不是新的消息接口。 - operationId: getFollow - parameters: - - $ref: "#/components/parameters/FriendUID" - responses: - "200": - description: 统一 envelope - content: - application/json: - schema: - $ref: "#/components/schemas/Envelope" - put: - tags: [friends] - summary: 关注 - description: | - 无请求体。只增加一条单向关注。只有一方关注时 `mutual` 与 `friend` 都为 false,不会成为好友。 - 若对方已经关注自己,这次关注使双方互相关注,则自动写入已有双向好友边(来源 `4`),并沿用成为好友的系统消息。已经是好友时不重复写这条系统消息。 - operationId: followUser - parameters: - - $ref: "#/components/parameters/FriendUID" - responses: - "200": - description: | - 统一 envelope。`data.following` 为 true。仅一方关注时 `mutual=false`、`friend=false`。互关成功时 `mutual=true`、`friend=true`。 - content: - application/json: - schema: - $ref: "#/components/schemas/Envelope" - delete: - tags: [friends] - summary: 取消关注 - description: | - 只删除自己这一条关注。若因此不再互相关注,删除双方好友边。不删除历史消息。 - 只有一方关注时取消关注,不改动已经存在的好友关系。 - operationId: unfollowUser - parameters: - - $ref: "#/components/parameters/FriendUID" - responses: - "200": - description: 统一 envelope。`data.following` 为 false。不再互关时 `friend` 为 false。 - content: - application/json: - schema: - $ref: "#/components/schemas/Envelope" /v1/follows/{uid}: get: tags: [friends]