Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/FormalClientBrowserService.md
+++ b/文档/FormalClientBrowserService.md
@@ -0,0 +1,189 @@
+# FormalClientBrowserService
+> 浏览器信息库服务
+
+---
+
+## countFormalClientBrowsers
+> 计算浏览器信息数量
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/FormalClientBrowserService/countFormalClientBrowsers`
+- RPC：`rpc countFormalClientBrowsers(CountFormalClientBrowsersRequest) returns (RPCCountResponse);`
+
+**请求对象 (`CountFormalClientBrowsersRequest`)**
+
+```json
+{
+  "keyword": "string // 可选"
+}
+```
+
+**响应对象 (`RPCCountResponse`)**
+
+```json
+{
+  "count": "int64 // 数量"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/FormalClientBrowserService/countFormalClientBrowsers" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## createFormalClientBrowser
+> 创建浏览器信息
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/FormalClientBrowserService/createFormalClientBrowser`
+- RPC：`rpc createFormalClientBrowser(CreateFormalClientBrowserRequest) returns (CreateFormalClientBrowserResponse);`
+
+**请求对象 (`CreateFormalClientBrowserRequest`)**
+
+```json
+{
+  "name": "string // 名称",
+  "codes": "[]string",
+  "dataId": "string"
+}
+```
+
+**响应对象 (`CreateFormalClientBrowserResponse`)**
+
+```json
+{
+  "formalClientBrowserId": "int64"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/FormalClientBrowserService/createFormalClientBrowser" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findFormalClientBrowserWithDataId
+> 通过dataId查询浏览器信息
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/FormalClientBrowserService/findFormalClientBrowserWithDataId`
+- RPC：`rpc findFormalClientBrowserWithDataId(FindFormalClientBrowserWithDataIdRequest) returns (FindFormalClientBrowserWithDataIdResponse);`
+
+**请求对象 (`FindFormalClientBrowserWithDataIdRequest`)**
+
+```json
+{
+  "dataId": "string"
+}
+```
+
+**响应对象 (`FindFormalClientBrowserWithDataIdResponse`)**
+
+```json
+{
+  "formalClientBrowser": "FormalClientBrowser"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/FormalClientBrowserService/findFormalClientBrowserWithDataId" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## listFormalClientBrowsers
+> 列出单页浏览器信息
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/FormalClientBrowserService/listFormalClientBrowsers`
+- RPC：`rpc listFormalClientBrowsers(ListFormalClientBrowsersRequest) returns (ListFormalClientBrowsersResponse);`
+
+**请求对象 (`ListFormalClientBrowsersRequest`)**
+
+```json
+{
+  "keyword": "string // 可选",
+  "offset": "int64 // 读取位置",
+  "size": "int64 // 数量，通常不能小于0"
+}
+```
+
+**响应对象 (`ListFormalClientBrowsersResponse`)**
+
+```json
+{
+  "formalClientBrowsers": "[]FormalClientBrowser"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/FormalClientBrowserService/listFormalClientBrowsers" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## updateFormalClientBrowser
+> 修改浏览器信息
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/FormalClientBrowserService/updateFormalClientBrowser`
+- RPC：`rpc updateFormalClientBrowser(UpdateFormalClientBrowserRequest) returns (RPCSuccess);`
+
+**请求对象 (`UpdateFormalClientBrowserRequest`)**
+
+```json
+{
+  "formalClientBrowserId": "int64",
+  "name": "string // 名称",
+  "codes": "[]string",
+  "dataId": "string"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/FormalClientBrowserService/updateFormalClientBrowser" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---