From 0e17dd421a42892efac3c23ce0f5be5771b8e24e Mon Sep 17 00:00:00 2001
From: XiaoMiku01 <loveava0612@outlook.com>
Date: Tue, 23 May 2023 11:52:42 +0800
Subject: [PATCH] =?UTF-8?q?[gRpc]=20=E6=B7=BB=E5=8A=A0=E8=AF=84=E8=AE=BA?=
 =?UTF-8?q?=E5=8C=BA=20At=20=E7=94=A8=E6=88=B7=E5=88=97=E8=A1=A8=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3=20(#681)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 增加新版动态点赞转发列表接口

* 更新包名 `interface`  -> `interfaces`

* 添加评论区 At 用户列表 gRPC 接口

* 添加grpc接口使用示例
---
 .../bilibili/relation/interfaces/api.proto    | 38 ++++++++++++++++++-
 grpc_api/readme.md                            | 26 +++++++------
 2 files changed, 52 insertions(+), 12 deletions(-)

diff --git a/grpc_api/bilibili/relation/interfaces/api.proto b/grpc_api/bilibili/relation/interfaces/api.proto
index 0ffdd02..6fe72cb 100644
--- a/grpc_api/bilibili/relation/interfaces/api.proto
+++ b/grpc_api/bilibili/relation/interfaces/api.proto
@@ -1 +1,37 @@
-// TODO
\ No newline at end of file
+syntax = "proto3";
+
+package bilibili.relation.interface.v1;
+
+service RelationInterface {
+    // 评论区 At 用户列表 (无需登录鉴权)
+    rpc AtSearch (AtSearchReq) returns (AtSearchReply);
+}
+
+message AtSearchReq {
+    // 可以为 1 , 但是不能为 0 或空 不知道有啥用
+    int64 mid = 1;
+    // 用户名搜索关键词
+    string keyword = 2;
+}
+
+message AtSearchReply {
+    // 搜索结果分组
+    repeated AtGroup items = 1;
+}
+
+message AtGroup {
+    // 分组类型  2: 我的关注 4:其他 ,其他自测
+    int32 group_type = 1;
+    // 分组名称
+    string group_name = 2;
+    // 用户列表
+    repeated AtItem items = 3;
+}
+
+message AtItem {
+  int64 mid = 1;
+  string name = 2;
+  string face = 3;
+  int32 fans = 4;
+  int32 official_verify_type = 5;
+}
diff --git a/grpc_api/readme.md b/grpc_api/readme.md
index 96d75a3..ea0e57f 100644
--- a/grpc_api/readme.md
+++ b/grpc_api/readme.md
@@ -1,34 +1,38 @@
-# grpc接口定义（protobuf结构体） 
+# grpc 接口定义（protobuf 结构体）
 
 注：
 
-1. proto结构体文件按照包名分类，同级放在同一目录中
+1. proto 结构体文件按照包名分类，同级放在同一目录中
 
 2. 暂时无说明文档，稍后添加
 
-3. 以下文件全部来自apk的逆向工程，如有疏漏请包涵
+3. 以下文件全部来自 apk 的逆向工程，如有疏漏请包涵
 
-## grpc主机
+## grpc 主机
 
-B站客户端的grpc接口主机为以下服务器
+B 站客户端的 grpc 接口主机为以下服务器
 
 > grpc.biliapi.net
 >
 > app.bilibili.com
 
-## grpc鉴权
+## grpc 鉴权
 
-需要在请求http头部中添加`access_key`，如下
+需要在请求 http 头部中添加`access_key`，如下
 
 ```
 authorization:identify_v1 {access_key}
 ```
 
-## grpc头部
+## grpc 头部
 
-- [bilibili.metadata](bilibili/metadata)：客户端环境参数
-- [bilibili.rpc](bilibili/rpc/status.proto)：响应错误信息
+-   [bilibili.metadata](bilibili/metadata)：客户端环境参数
+-   [bilibili.rpc](bilibili/rpc/status.proto)：响应错误信息
 
 ## 接口请求定义
 
-*稍后补充*
\ No newline at end of file
+_稍后补充_
+
+## 示例
+
+B 站 gRPC API Golang 封装：[XiaoMiku01/bilibili-grpc-api-go](https://github.com/XiaoMiku01/bilibili-grpc-api-go)