bsm-infra/full
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add unified authorization middleware

Browse Source
This commit is contained in:
yanweidong
2026-08-12 11:46:48 +08:00
parent 2d1deb54f0
commit fa6898aef8
31 changed files with 341 additions and 490 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
wiki/api/00-overview.md
View File

@@ -15,7 +15,7 @@
```http
POST /rpc/passport/Login/Pwd
Authorization: Bearer <token>
Authorization: <JWT>
Content-Type: application/json
{"account":"demo","password":"secret"}
@@ -37,8 +37,8 @@ Content-Type: application/json
```json
{
"code": 7,
"message": "dynamic RPC method is not allowed",
"code": 3,
"message": "invalid protobuf JSON: ...",
"details": []
}
```
@@ -67,23 +67,10 @@ Content-Type: application/json
需要身份的接口统一发送：
```http
Authorization: Bearer <token>
Authorization: <JWT>
```
具体方法是否允许匿名由服务实现和 gRPC interceptor 决定。客户端不应仅根据请求字段推断匿名权限。
## 动态 RPC 白名单
`all/etc/<workspace>_<runtime>.yaml` 的 `DynamicRPC.Allow` 控制可调用范围：
```yaml
DynamicRPC:
Allow:
- passport.Login.Pwd
- passport.Register
```
支持完整方法名、完整服务名或 `*`。生产环境不建议使用 `*`。
请求头直接传递 JWT，不添加 `Bearer` 前缀。`all` 使用 `Authorization.Key` 验证 HS256 签名，并根据 token 的 `exp` 与 `Authorization.Expire` 校验有效期；是否匿名由 `Authorization.Anonymous` 配置决定。
## 当前限制与风险

3
wiki/api/01-ads.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/ads/{Service}/{Method}`
- 原生 gRPC：`/ads.{Service}/{Method}`
- grpc-gateway：`POST /ads.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -28,7 +28,6 @@
- 动态 HTTP：`POST /rpc/ads/Fetch/ByPos`
- gRPC：`/ads.Fetch/ByPos`
- 白名单键：`ads.Fetch.ByPos`
- 请求示例：
```json

61
wiki/api/02-cloud.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/cloud/{Service}/{Method}`
- 原生 gRPC：`/cloud.{Service}/{Method}`
- grpc-gateway：`POST /cloud.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -45,7 +45,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/CreateAlbum`
- gRPC：`/cloud.Album/CreateAlbum`
- 白名单键：`cloud.Album.CreateAlbum`
- 请求示例：
```json
@@ -63,7 +62,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/GetAlbum`
- gRPC：`/cloud.Album/GetAlbum`
- 白名单键：`cloud.Album.GetAlbum`
- 请求示例：
```json
@@ -77,7 +75,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/UpdateAlbum`
- gRPC：`/cloud.Album/UpdateAlbum`
- 白名单键：`cloud.Album.UpdateAlbum`
- 请求示例：
```json
@@ -117,7 +114,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/DeleteAlbum`
- gRPC：`/cloud.Album/DeleteAlbum`
- 白名单键：`cloud.Album.DeleteAlbum`
- 请求示例：
```json
@@ -131,7 +127,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/ListAlbums`
- gRPC：`/cloud.Album/ListAlbums`
- 白名单键：`cloud.Album.ListAlbums`
- 请求示例：
```json
@@ -148,7 +143,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/SetCoverPhoto`
- gRPC：`/cloud.Album/SetCoverPhoto`
- 白名单键：`cloud.Album.SetCoverPhoto`
- 请求示例：
```json
@@ -162,7 +156,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/UploadPhoto`
- gRPC：`/cloud.Album/UploadPhoto`
- 白名单键：`cloud.Album.UploadPhoto`
- 请求示例：
```json
@@ -202,7 +195,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/GetPhoto`
- gRPC：`/cloud.Album/GetPhoto`
- 白名单键：`cloud.Album.GetPhoto`
- 请求示例：
```json
@@ -216,7 +208,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/UpdatePhoto`
- gRPC：`/cloud.Album/UpdatePhoto`
- 白名单键：`cloud.Album.UpdatePhoto`
- 请求示例：
```json
@@ -256,7 +247,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/DeletePhoto`
- gRPC：`/cloud.Album/DeletePhoto`
- 白名单键：`cloud.Album.DeletePhoto`
- 请求示例：
```json
@@ -270,7 +260,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/ListPhotos`
- gRPC：`/cloud.Album/ListPhotos`
- 白名单键：`cloud.Album.ListPhotos`
- 请求示例：
```json
@@ -287,7 +276,6 @@
- 动态 HTTP：`POST /rpc/cloud/Album/MovePhoto`
- gRPC：`/cloud.Album/MovePhoto`
- 白名单键：`cloud.Album.MovePhoto`
- 请求示例：
```json
@@ -312,7 +300,6 @@
- 动态 HTTP：`POST /rpc/cloud/Bookmark/CreateBookmark`
- gRPC：`/cloud.Bookmark/CreateBookmark`
- 白名单键：`cloud.Bookmark.CreateBookmark`
- 请求示例：
```json
@@ -333,7 +320,6 @@
- 动态 HTTP：`POST /rpc/cloud/Bookmark/GetBookmark`
- gRPC：`/cloud.Bookmark/GetBookmark`
- 白名单键：`cloud.Bookmark.GetBookmark`
- 请求示例：
```json
@@ -346,7 +332,6 @@
- 动态 HTTP：`POST /rpc/cloud/Bookmark/UpdateBookmark`
- gRPC：`/cloud.Bookmark/UpdateBookmark`
- 白名单键：`cloud.Bookmark.UpdateBookmark`
- 请求示例：
```json
@@ -369,7 +354,6 @@
- 动态 HTTP：`POST /rpc/cloud/Bookmark/DeleteBookmark`
- gRPC：`/cloud.Bookmark/DeleteBookmark`
- 白名单键：`cloud.Bookmark.DeleteBookmark`
- 请求示例：
```json
@@ -382,7 +366,6 @@
- 动态 HTTP：`POST /rpc/cloud/Bookmark/ListBookmarks`
- gRPC：`/cloud.Bookmark/ListBookmarks`
- 白名单键：`cloud.Bookmark.ListBookmarks`
- 请求示例：
```json
@@ -399,7 +382,6 @@
- 动态 HTTP：`POST /rpc/cloud/Bookmark/ImportBookmarks`
- gRPC：`/cloud.Bookmark/ImportBookmarks`
- 白名单键：`cloud.Bookmark.ImportBookmarks`
- 请求示例：
```json
@@ -433,7 +415,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/CreateDir`
- gRPC：`/cloud.Disk/CreateDir`
- 白名单键：`cloud.Disk.CreateDir`
- 请求示例：
```json
@@ -450,7 +431,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/GetDir`
- gRPC：`/cloud.Disk/GetDir`
- 白名单键：`cloud.Disk.GetDir`
- 请求示例：
```json
@@ -464,7 +444,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/UpdateDir`
- gRPC：`/cloud.Disk/UpdateDir`
- 白名单键：`cloud.Disk.UpdateDir`
- 请求示例：
```json
@@ -503,7 +482,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/DeleteDir`
- gRPC：`/cloud.Disk/DeleteDir`
- 白名单键：`cloud.Disk.DeleteDir`
- 请求示例：
```json
@@ -517,7 +495,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/ListDirs`
- gRPC：`/cloud.Disk/ListDirs`
- 白名单键：`cloud.Disk.ListDirs`
- 请求示例：
```json
@@ -534,7 +511,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/GetDirTree`
- gRPC：`/cloud.Disk/GetDirTree`
- 白名单键：`cloud.Disk.GetDirTree`
- 请求示例：
```json
@@ -548,7 +524,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/MoveDir`
- gRPC：`/cloud.Disk/MoveDir`
- 白名单键：`cloud.Disk.MoveDir`
- 请求示例：
```json
@@ -562,7 +537,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/UploadFile`
- gRPC：`/cloud.Disk/UploadFile`
- 白名单键：`cloud.Disk.UploadFile`
- 请求示例：
```json
@@ -583,7 +557,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/GetFile`
- gRPC：`/cloud.Disk/GetFile`
- 白名单键：`cloud.Disk.GetFile`
- 请求示例：
```json
@@ -597,7 +570,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/UpdateFile`
- gRPC：`/cloud.Disk/UpdateFile`
- 白名单键：`cloud.Disk.UpdateFile`
- 请求示例：
```json
@@ -636,7 +608,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/DeleteFile`
- gRPC：`/cloud.Disk/DeleteFile`
- 白名单键：`cloud.Disk.DeleteFile`
- 请求示例：
```json
@@ -650,7 +621,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/ListFiles`
- gRPC：`/cloud.Disk/ListFiles`
- 白名单键：`cloud.Disk.ListFiles`
- 请求示例：
```json
@@ -667,7 +637,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/MoveFile`
- gRPC：`/cloud.Disk/MoveFile`
- 白名单键：`cloud.Disk.MoveFile`
- 请求示例：
```json
@@ -681,7 +650,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/CopyFile`
- gRPC：`/cloud.Disk/CopyFile`
- 白名单键：`cloud.Disk.CopyFile`
- 请求示例：
```json
@@ -696,7 +664,6 @@
- 动态 HTTP：`POST /rpc/cloud/Disk/SearchFiles`
- gRPC：`/cloud.Disk/SearchFiles`
- 白名单键：`cloud.Disk.SearchFiles`
- 请求示例：
```json
@@ -728,7 +695,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/CreateNote`
- gRPC：`/cloud.Note/CreateNote`
- 白名单键：`cloud.Note.CreateNote`
- 请求示例：
```json
@@ -749,7 +715,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/GetNote`
- gRPC：`/cloud.Note/GetNote`
- 白名单键：`cloud.Note.GetNote`
- 请求示例：
```json
@@ -763,7 +728,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/UpdateNote`
- gRPC：`/cloud.Note/UpdateNote`
- 白名单键：`cloud.Note.UpdateNote`
- 请求示例：
```json
@@ -798,7 +762,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/DeleteNote`
- gRPC：`/cloud.Note/DeleteNote`
- 白名单键：`cloud.Note.DeleteNote`
- 请求示例：
```json
@@ -812,7 +775,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/ListNotes`
- gRPC：`/cloud.Note/ListNotes`
- 白名单键：`cloud.Note.ListNotes`
- 请求示例：
```json
@@ -829,7 +791,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/TogglePin`
- gRPC：`/cloud.Note/TogglePin`
- 白名单键：`cloud.Note.TogglePin`
- 请求示例：
```json
@@ -843,7 +804,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/IncrementViews`
- gRPC：`/cloud.Note/IncrementViews`
- 白名单键：`cloud.Note.IncrementViews`
- 请求示例：
```json
@@ -857,7 +817,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/SearchNotes`
- gRPC：`/cloud.Note/SearchNotes`
- 白名单键：`cloud.Note.SearchNotes`
- 请求示例：
```json
@@ -874,7 +833,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/InsertAttachment`
- gRPC：`/cloud.Note/InsertAttachment`
- 白名单键：`cloud.Note.InsertAttachment`
- 请求示例：
```json
@@ -893,7 +851,6 @@
- 动态 HTTP：`POST /rpc/cloud/Note/DeleteAttachment`
- gRPC：`/cloud.Note/DeleteAttachment`
- 白名单键：`cloud.Note.DeleteAttachment`
- 请求示例：
```json
@@ -921,7 +878,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/CreatePrivateData`
- gRPC：`/cloud.Private/CreatePrivateData`
- 白名单键：`cloud.Private.CreatePrivateData`
- 请求示例：
```json
@@ -941,7 +897,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/GetPrivateData`
- gRPC：`/cloud.Private/GetPrivateData`
- 白名单键：`cloud.Private.GetPrivateData`
- 请求示例：
```json
@@ -955,7 +910,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/UpdatePrivateData`
- gRPC：`/cloud.Private/UpdatePrivateData`
- 白名单键：`cloud.Private.UpdatePrivateData`
- 请求示例：
```json
@@ -977,7 +931,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/DeletePrivateData`
- gRPC：`/cloud.Private/DeletePrivateData`
- 白名单键：`cloud.Private.DeletePrivateData`
- 请求示例：
```json
@@ -991,7 +944,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/ListPrivateData`
- gRPC：`/cloud.Private/ListPrivateData`
- 白名单键：`cloud.Private.ListPrivateData`
- 请求示例：
```json
@@ -1008,7 +960,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/GetPrivateDataByType`
- gRPC：`/cloud.Private/GetPrivateDataByType`
- 白名单键：`cloud.Private.GetPrivateDataByType`
- 请求示例：
```json
@@ -1025,7 +976,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/SearchPrivateData`
- gRPC：`/cloud.Private/SearchPrivateData`
- 白名单键：`cloud.Private.SearchPrivateData`
- 请求示例：
```json
@@ -1042,7 +992,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/EncryptData`
- gRPC：`/cloud.Private/EncryptData`
- 白名单键：`cloud.Private.EncryptData`
- 请求示例：
```json
@@ -1056,7 +1005,6 @@
- 动态 HTTP：`POST /rpc/cloud/Private/DecryptData`
- gRPC：`/cloud.Private/DecryptData`
- 白名单键：`cloud.Private.DecryptData`
- 请求示例：
```json
@@ -1080,7 +1028,6 @@
- 动态 HTTP：`POST /rpc/cloud/Share/CreateShare`
- gRPC：`/cloud.Share/CreateShare`
- 白名单键：`cloud.Share.CreateShare`
- 请求示例：
```json
@@ -1100,7 +1047,6 @@
- 动态 HTTP：`POST /rpc/cloud/Share/GetShare`
- gRPC：`/cloud.Share/GetShare`
- 白名单键：`cloud.Share.GetShare`
- 请求示例：
```json
@@ -1114,7 +1060,6 @@
- 动态 HTTP：`POST /rpc/cloud/Share/DeleteShare`
- gRPC：`/cloud.Share/DeleteShare`
- 白名单键：`cloud.Share.DeleteShare`
- 请求示例：
```json
@@ -1128,7 +1073,6 @@
- 动态 HTTP：`POST /rpc/cloud/Share/ListShares`
- gRPC：`/cloud.Share/ListShares`
- 白名单键：`cloud.Share.ListShares`
- 请求示例：
```json
@@ -1145,7 +1089,6 @@
- 动态 HTTP：`POST /rpc/cloud/Share/ValidateSharePassword`
- gRPC：`/cloud.Share/ValidateSharePassword`
- 白名单键：`cloud.Share.ValidateSharePassword`
- 请求示例：
```json
@@ -1166,7 +1109,6 @@
- 动态 HTTP：`POST /rpc/cloud/Space/Get`
- gRPC：`/cloud.Space/Get`
- 白名单键：`cloud.Space.Get`
- 请求示例：
```json
@@ -1177,7 +1119,6 @@
- 动态 HTTP：`POST /rpc/cloud/Space/GetByKeyIdentifier`
- gRPC：`/cloud.Space/GetByKeyIdentifier`
- 白名单键：`cloud.Space.GetByKeyIdentifier`
- 请求示例：
```json

40
wiki/api/03-cms.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/cms/{Service}/{Method}`
- 原生 gRPC：`/cms.{Service}/{Method}`
- grpc-gateway：`POST /cms.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -35,7 +35,6 @@
- 动态 HTTP：`POST /rpc/cms/Category/Fetch`
- gRPC：`/cms.Category/Fetch`
- 白名单键：`cms.Category.Fetch`
- 请求示例：
```json
@@ -49,7 +48,6 @@
- 动态 HTTP：`POST /rpc/cms/Category/Create`
- gRPC：`/cms.Category/Create`
- 白名单键：`cms.Category.Create`
- 请求示例：
```json
@@ -74,7 +72,6 @@
- 动态 HTTP：`POST /rpc/cms/Category/Modify`
- gRPC：`/cms.Category/Modify`
- 白名单键：`cms.Category.Modify`
- 请求示例：
```json
@@ -112,7 +109,6 @@
- 动态 HTTP：`POST /rpc/cms/Category/Delete`
- gRPC：`/cms.Category/Delete`
- 白名单键：`cms.Category.Delete`
- 请求示例：
```json
@@ -136,7 +132,6 @@
- 动态 HTTP：`POST /rpc/cms/Pages/Fetch`
- gRPC：`/cms.Pages/Fetch`
- 白名单键：`cms.Pages.Fetch`
- 请求示例：
```json
@@ -152,7 +147,6 @@
- 动态 HTTP：`POST /rpc/cms/Pages/GetByIdentity`
- gRPC：`/cms.Pages/GetByIdentity`
- 白名单键：`cms.Pages.GetByIdentity`
- 请求示例：
```json
@@ -165,7 +159,6 @@
- 动态 HTTP：`POST /rpc/cms/Pages/GetByKey`
- gRPC：`/cms.Pages/GetByKey`
- 白名单键：`cms.Pages.GetByKey`
- 请求示例：
```json
@@ -178,7 +171,6 @@
- 动态 HTTP：`POST /rpc/cms/Pages/Create`
- gRPC：`/cms.Pages/Create`
- 白名单键：`cms.Pages.Create`
- 请求示例：
```json
@@ -227,7 +219,6 @@
- 动态 HTTP：`POST /rpc/cms/Pages/Modify`
- gRPC：`/cms.Pages/Modify`
- 白名单键：`cms.Pages.Modify`
- 请求示例：
```json
@@ -276,7 +267,6 @@
- 动态 HTTP：`POST /rpc/cms/Pages/Delete`
- gRPC：`/cms.Pages/Delete`
- 白名单键：`cms.Pages.Delete`
- 请求示例：
```json
@@ -314,7 +304,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/Fetch`
- gRPC：`/cms.Post/Fetch`
- 白名单键：`cms.Post.Fetch`
- 请求示例：
```json
@@ -332,7 +321,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/GetByIdentity`
- gRPC：`/cms.Post/GetByIdentity`
- 白名单键：`cms.Post.GetByIdentity`
- 请求示例：
```json
@@ -346,7 +334,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/GetByKey`
- gRPC：`/cms.Post/GetByKey`
- 白名单键：`cms.Post.GetByKey`
- 请求示例：
```json
@@ -359,7 +346,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/Search`
- gRPC：`/cms.Post/Search`
- 白名单键：`cms.Post.Search`
- 请求示例：
```json
@@ -374,7 +360,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/Create`
- gRPC：`/cms.Post/Create`
- 白名单键：`cms.Post.Create`
- 请求示例：
```json
@@ -460,7 +445,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/Modify`
- gRPC：`/cms.Post/Modify`
- 白名单键：`cms.Post.Modify`
- 请求示例：
```json
@@ -546,7 +530,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/Delete`
- gRPC：`/cms.Post/Delete`
- 白名单键：`cms.Post.Delete`
- 请求示例：
```json
@@ -560,7 +543,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/IncrPostLike`
- gRPC：`/cms.Post/IncrPostLike`
- 白名单键：`cms.Post.IncrPostLike`
- 请求示例：
```json
@@ -574,7 +556,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/DescPostLike`
- gRPC：`/cms.Post/DescPostLike`
- 白名单键：`cms.Post.DescPostLike`
- 请求示例：
```json
@@ -588,7 +569,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/IncrPostUnlike`
- gRPC：`/cms.Post/IncrPostUnlike`
- 白名单键：`cms.Post.IncrPostUnlike`
- 请求示例：
```json
@@ -602,7 +582,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/DescPostUnlike`
- gRPC：`/cms.Post/DescPostUnlike`
- 白名单键：`cms.Post.DescPostUnlike`
- 请求示例：
```json
@@ -616,7 +595,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/CommentList`
- gRPC：`/cms.Post/CommentList`
- 白名单键：`cms.Post.CommentList`
- 请求示例：
```json
@@ -631,7 +609,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/AddComment`
- gRPC：`/cms.Post/AddComment`
- 白名单键：`cms.Post.AddComment`
- 请求示例：
```json
@@ -659,7 +636,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/ModifyComment`
- gRPC：`/cms.Post/ModifyComment`
- 白名单键：`cms.Post.ModifyComment`
- 请求示例：
```json
@@ -687,7 +663,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/DeleteComment`
- gRPC：`/cms.Post/DeleteComment`
- 白名单键：`cms.Post.DeleteComment`
- 请求示例：
```json
@@ -701,7 +676,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/IncrCommentLike`
- gRPC：`/cms.Post/IncrCommentLike`
- 白名单键：`cms.Post.IncrCommentLike`
- 请求示例：
```json
@@ -715,7 +689,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/DescCommentLike`
- gRPC：`/cms.Post/DescCommentLike`
- 白名单键：`cms.Post.DescCommentLike`
- 请求示例：
```json
@@ -729,7 +702,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/IncrCommentUnlike`
- gRPC：`/cms.Post/IncrCommentUnlike`
- 白名单键：`cms.Post.IncrCommentUnlike`
- 请求示例：
```json
@@ -743,7 +715,6 @@
- 动态 HTTP：`POST /rpc/cms/Post/DescCommentUnlike`
- gRPC：`/cms.Post/DescCommentUnlike`
- 白名单键：`cms.Post.DescCommentUnlike`
- 请求示例：
```json
@@ -767,7 +738,6 @@
- 动态 HTTP：`POST /rpc/cms/Site/Fetch`
- gRPC：`/cms.Site/Fetch`
- 白名单键：`cms.Site.Fetch`
- 请求示例：
```json
@@ -778,7 +748,6 @@
- 动态 HTTP：`POST /rpc/cms/Site/Get`
- gRPC：`/cms.Site/Get`
- 白名单键：`cms.Site.Get`
- 请求示例：
```json
@@ -792,7 +761,6 @@
- 动态 HTTP：`POST /rpc/cms/Site/Create`
- gRPC：`/cms.Site/Create`
- 白名单键：`cms.Site.Create`
- 请求示例：
```json
@@ -814,7 +782,6 @@
- 动态 HTTP：`POST /rpc/cms/Site/Modify`
- gRPC：`/cms.Site/Modify`
- 白名单键：`cms.Site.Modify`
- 请求示例：
```json
@@ -836,7 +803,6 @@
- 动态 HTTP：`POST /rpc/cms/Site/Delete`
- gRPC：`/cms.Site/Delete`
- 白名单键：`cms.Site.Delete`
- 请求示例：
```json
@@ -859,7 +825,6 @@
- 动态 HTTP：`POST /rpc/cms/Tags/Fetch`
- gRPC：`/cms.Tags/Fetch`
- 白名单键：`cms.Tags.Fetch`
- 请求示例：
```json
@@ -873,7 +838,6 @@
- 动态 HTTP：`POST /rpc/cms/Tags/Create`
- gRPC：`/cms.Tags/Create`
- 白名单键：`cms.Tags.Create`
- 请求示例：
```json
@@ -891,7 +855,6 @@
- 动态 HTTP：`POST /rpc/cms/Tags/Modify`
- gRPC：`/cms.Tags/Modify`
- 白名单键：`cms.Tags.Modify`
- 请求示例：
```json
@@ -909,7 +872,6 @@
- 动态 HTTP：`POST /rpc/cms/Tags/Delete`
- gRPC：`/cms.Tags/Delete`
- 白名单键：`cms.Tags.Delete`
- 请求示例：
```json

8
wiki/api/04-feedback.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/feedback/{Service}/{Method}`
- 原生 gRPC：`/feedback.{Service}/{Method}`
- grpc-gateway：`POST /feedback.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -33,7 +33,6 @@
- 动态 HTTP：`POST /rpc/feedback/Method/List`
- gRPC：`/feedback.Method/List`
- 白名单键：`feedback.Method.List`
- 请求示例：
```json
@@ -55,7 +54,6 @@
- 动态 HTTP：`POST /rpc/feedback/Method/Get`
- gRPC：`/feedback.Method/Get`
- 白名单键：`feedback.Method.Get`
- 请求示例：
```json
@@ -68,7 +66,6 @@
- 动态 HTTP：`POST /rpc/feedback/Method/Add`
- gRPC：`/feedback.Method/Add`
- 白名单键：`feedback.Method.Add`
- 请求示例：
```json
@@ -105,7 +102,6 @@
- 动态 HTTP：`POST /rpc/feedback/Method/Modify`
- gRPC：`/feedback.Method/Modify`
- 白名单键：`feedback.Method.Modify`
- 请求示例：
```json
@@ -143,7 +139,6 @@
- 动态 HTTP：`POST /rpc/feedback/Method/Delete`
- gRPC：`/feedback.Method/Delete`
- 白名单键：`feedback.Method.Delete`
- 请求示例：
```json
@@ -156,7 +151,6 @@
- 动态 HTTP：`POST /rpc/feedback/Method/Remark`
- gRPC：`/feedback.Method/Remark`
- 白名单键：`feedback.Method.Remark`
- 请求示例：
```json

8
wiki/api/05-initial.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/initial/{Service}/{Method}`
- 原生 gRPC：`/initial.{Service}/{Method}`
- grpc-gateway：`POST /initial.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -31,7 +31,6 @@
- 动态 HTTP：`POST /rpc/initial/Check/Hello`
- gRPC：`/initial.Check/Hello`
- 白名单键：`initial.Check.Hello`
- 请求示例：
```json
@@ -44,7 +43,6 @@
- 动态 HTTP：`POST /rpc/initial/Check/Config`
- gRPC：`/initial.Check/Config`
- 白名单键：`initial.Check.Config`
- 请求示例：
```json
@@ -58,7 +56,6 @@
- 动态 HTTP：`POST /rpc/initial/Check/Updates`
- gRPC：`/initial.Check/Updates`
- 白名单键：`initial.Check.Updates`
- 请求示例：
```json
@@ -82,7 +79,6 @@
- 动态 HTTP：`POST /rpc/initial/Data/Country`
- gRPC：`/initial.Data/Country`
- 白名单键：`initial.Data.Country`
- 请求示例：
```json
@@ -93,7 +89,6 @@
- 动态 HTTP：`POST /rpc/initial/Data/Areas`
- gRPC：`/initial.Data/Areas`
- 白名单键：`initial.Data.Areas`
- 请求示例：
```json
@@ -108,7 +103,6 @@
- 动态 HTTP：`POST /rpc/initial/Data/Datas`
- gRPC：`/initial.Data/Datas`
- 白名单键：`initial.Data.Datas`
- 请求示例：
```json

17
wiki/api/06-passport.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/passport/{Service}/{Method}`
- 原生 gRPC：`/passport.{Service}/{Method}`
- grpc-gateway：`POST /passport.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -37,7 +37,6 @@
- 动态 HTTP：`POST /rpc/passport/Account/Get`
- gRPC：`/passport.Account/Get`
- 白名单键：`passport.Account.Get`
- 请求示例：
```json
@@ -48,7 +47,6 @@
- 动态 HTTP：`POST /rpc/passport/Account/SetData`
- gRPC：`/passport.Account/SetData`
- 白名单键：`passport.Account.SetData`
- 请求示例：
```json
@@ -72,7 +70,6 @@
- 动态 HTTP：`POST /rpc/passport/Account/SetPassword`
- gRPC：`/passport.Account/SetPassword`
- 白名单键：`passport.Account.SetPassword`
- 请求示例：
```json
@@ -86,7 +83,6 @@
- 动态 HTTP：`POST /rpc/passport/Account/TagCreate`
- gRPC：`/passport.Account/TagCreate`
- 白名单键：`passport.Account.TagCreate`
- 请求示例：
```json
@@ -100,7 +96,6 @@
- 动态 HTTP：`POST /rpc/passport/Account/TagRemove`
- gRPC：`/passport.Account/TagRemove`
- 白名单键：`passport.Account.TagRemove`
- 请求示例：
```json
@@ -114,7 +109,6 @@
- 动态 HTTP：`POST /rpc/passport/Account/Statistics`
- gRPC：`/passport.Account/Statistics`
- 白名单键：`passport.Account.Statistics`
- 请求示例：
```json
@@ -136,7 +130,6 @@
- 动态 HTTP：`POST /rpc/passport/Forget/Verify`
- gRPC：`/passport.Forget/Verify`
- 白名单键：`passport.Forget.Verify`
- 请求示例：
```json
@@ -150,7 +143,6 @@
- 动态 HTTP：`POST /rpc/passport/Forget/Reset`
- gRPC：`/passport.Forget/Reset`
- 白名单键：`passport.Forget.Reset`
- 请求示例：
```json
@@ -172,7 +164,6 @@
- 动态 HTTP：`POST /rpc/passport/Login/Pwd`
- gRPC：`/passport.Login/Pwd`
- 白名单键：`passport.Login.Pwd`
- 请求示例：
```json
@@ -186,7 +177,6 @@
- 动态 HTTP：`POST /rpc/passport/Login/Code`
- gRPC：`/passport.Login/Code`
- 白名单键：`passport.Login.Code`
- 请求示例：
```json
@@ -205,7 +195,6 @@
- 动态 HTTP：`POST /rpc/passport/Login/Quick`
- gRPC：`/passport.Login/Quick`
- 白名单键：`passport.Login.Quick`
- 请求示例：
```json
@@ -231,7 +220,6 @@
- 动态 HTTP：`POST /rpc/passport/Register/Pwd`
- gRPC：`/passport.Register/Pwd`
- 白名单键：`passport.Register.Pwd`
- 请求示例：
```json
@@ -253,7 +241,6 @@
- 动态 HTTP：`POST /rpc/passport/Register/Code`
- gRPC：`/passport.Register/Code`
- 白名单键：`passport.Register.Code`
- 请求示例：
```json
@@ -282,7 +269,6 @@
- 动态 HTTP：`POST /rpc/passport/Verify/Request`
- gRPC：`/passport.Verify/Request`
- 白名单键：`passport.Verify.Request`
- 请求示例：
```json
@@ -298,7 +284,6 @@
- 动态 HTTP：`POST /rpc/passport/Verify/JumioCallback`
- gRPC：`/passport.Verify/JumioCallback`
- 白名单键：`passport.Verify.JumioCallback`
- 请求示例：
```json

5
wiki/api/07-sender.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/sender/{Service}/{Method}`
- 原生 gRPC：`/sender.{Service}/{Method}`
- grpc-gateway：`POST /sender.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -29,7 +29,6 @@
- 动态 HTTP：`POST /rpc/sender/Mail/Send`
- gRPC：`/sender.Mail/Send`
- 白名单键：`sender.Mail.Send`
- 请求示例：
```json
@@ -55,7 +54,6 @@
- 动态 HTTP：`POST /rpc/sender/Sms/Send`
- gRPC：`/sender.Sms/Send`
- 白名单键：`sender.Sms.Send`
- 请求示例：
```json
@@ -75,7 +73,6 @@
- 动态 HTTP：`POST /rpc/sender/Sms/Verify`
- gRPC：`/sender.Sms/Verify`
- 白名单键：`sender.Sms.Verify`
- 请求示例：
```json

7
wiki/api/08-address.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/address/{Service}/{Method}`
- 原生 gRPC：`/address.{Service}/{Method}`
- grpc-gateway：`POST /address.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -32,7 +32,6 @@
- 动态 HTTP：`POST /rpc/address/Library/Create`
- gRPC：`/address.Library/Create`
- 白名单键：`address.Library.Create`
- 请求示例：
```json
@@ -54,7 +53,6 @@
- 动态 HTTP：`POST /rpc/address/Library/Modify`
- gRPC：`/address.Library/Modify`
- 白名单键：`address.Library.Modify`
- 请求示例：
```json
@@ -78,7 +76,6 @@
- 动态 HTTP：`POST /rpc/address/Library/Get`
- gRPC：`/address.Library/Get`
- 白名单键：`address.Library.Get`
- 请求示例：
```json
@@ -92,7 +89,6 @@
- 动态 HTTP：`POST /rpc/address/Library/Fetch`
- gRPC：`/address.Library/Fetch`
- 白名单键：`address.Library.Fetch`
- 请求示例：
```json
@@ -106,7 +102,6 @@
- 动态 HTTP：`POST /rpc/address/Library/Delete`
- gRPC：`/address.Library/Delete`
- 白名单键：`address.Library.Delete`
- 请求示例：
```json

62
wiki/api/09-mall.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/mall/{Service}/{Method}`
- 原生 gRPC：`/mall.{Service}/{Method}`
- grpc-gateway：`POST /mall.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -38,7 +38,6 @@
- 动态 HTTP：`POST /rpc/mall/Ads/ByPos`
- gRPC：`/mall.Ads/ByPos`
- 白名单键：`mall.Ads.ByPos`
- 请求示例：
```json
@@ -54,7 +53,6 @@
- 动态 HTTP：`POST /rpc/mall/Ads/Fetch`
- gRPC：`/mall.Ads/Fetch`
- 白名单键：`mall.Ads.Fetch`
- 请求示例：
```json
@@ -79,7 +77,6 @@
- 动态 HTTP：`POST /rpc/mall/Ads/Create`
- gRPC：`/mall.Ads/Create`
- 白名单键：`mall.Ads.Create`
- 请求示例：
```json
@@ -99,7 +96,6 @@
- 动态 HTTP：`POST /rpc/mall/Ads/Modify`
- gRPC：`/mall.Ads/Modify`
- 白名单键：`mall.Ads.Modify`
- 请求示例：
```json
@@ -119,7 +115,6 @@
- 动态 HTTP：`POST /rpc/mall/Ads/Delete`
- gRPC：`/mall.Ads/Delete`
- 白名单键：`mall.Ads.Delete`
- 请求示例：
```json
@@ -142,7 +137,6 @@
- 动态 HTTP：`POST /rpc/mall/Category/Fetch`
- gRPC：`/mall.Category/Fetch`
- 白名单键：`mall.Category.Fetch`
- 请求示例：
```json
@@ -158,7 +152,6 @@
- 动态 HTTP：`POST /rpc/mall/Category/Create`
- gRPC：`/mall.Category/Create`
- 白名单键：`mall.Category.Create`
- 请求示例：
```json
@@ -185,7 +178,6 @@
- 动态 HTTP：`POST /rpc/mall/Category/Delete`
- gRPC：`/mall.Category/Delete`
- 白名单键：`mall.Category.Delete`
- 请求示例：
```json
@@ -199,7 +191,6 @@
- 动态 HTTP：`POST /rpc/mall/Category/Modify`
- gRPC：`/mall.Category/Modify`
- 白名单键：`mall.Category.Modify`
- 请求示例：
```json
@@ -240,7 +231,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/Fetch`
- gRPC：`/mall.Freight/Fetch`
- 白名单键：`mall.Freight.Fetch`
- 请求示例：
```json
@@ -265,7 +255,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/Modify`
- gRPC：`/mall.Freight/Modify`
- 白名单键：`mall.Freight.Modify`
- 请求示例：
```json
@@ -308,7 +297,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/Delete`
- gRPC：`/mall.Freight/Delete`
- 白名单键：`mall.Freight.Delete`
- 请求示例：
```json
@@ -322,7 +310,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/Create`
- gRPC：`/mall.Freight/Create`
- 白名单键：`mall.Freight.Create`
- 请求示例：
```json
@@ -365,7 +352,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/Detail`
- gRPC：`/mall.Freight/Detail`
- 白名单键：`mall.Freight.Detail`
- 请求示例：
```json
@@ -379,7 +365,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/DenyRegionFetch`
- gRPC：`/mall.Freight/DenyRegionFetch`
- 白名单键：`mall.Freight.DenyRegionFetch`
- 请求示例：
```json
@@ -404,7 +389,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/DenyRegionCreate`
- gRPC：`/mall.Freight/DenyRegionCreate`
- 白名单键：`mall.Freight.DenyRegionCreate`
- 请求示例：
```json
@@ -429,7 +413,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/DenyRegionDelete`
- gRPC：`/mall.Freight/DenyRegionDelete`
- 白名单键：`mall.Freight.DenyRegionDelete`
- 请求示例：
```json
@@ -443,7 +426,6 @@
- 动态 HTTP：`POST /rpc/mall/Freight/DenyRegionModify`
- gRPC：`/mall.Freight/DenyRegionModify`
- 白名单键：`mall.Freight.DenyRegionModify`
- 请求示例：
```json
@@ -477,7 +459,6 @@
- 动态 HTTP：`POST /rpc/mall/Notice/Fetch`
- gRPC：`/mall.Notice/Fetch`
- 白名单键：`mall.Notice.Fetch`
- 请求示例：
```json
@@ -502,7 +483,6 @@
- 动态 HTTP：`POST /rpc/mall/Notice/Create`
- gRPC：`/mall.Notice/Create`
- 白名单键：`mall.Notice.Create`
- 请求示例：
```json
@@ -522,7 +502,6 @@
- 动态 HTTP：`POST /rpc/mall/Notice/Modify`
- gRPC：`/mall.Notice/Modify`
- 白名单键：`mall.Notice.Modify`
- 请求示例：
```json
@@ -542,7 +521,6 @@
- 动态 HTTP：`POST /rpc/mall/Notice/Delete`
- gRPC：`/mall.Notice/Delete`
- 白名单键：`mall.Notice.Delete`
- 请求示例：
```json
@@ -582,7 +560,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemFetch`
- gRPC：`/mall.Product/ItemFetch`
- 白名单键：`mall.Product.ItemFetch`
- 请求示例：
```json
@@ -607,7 +584,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemDetail`
- gRPC：`/mall.Product/ItemDetail`
- 白名单键：`mall.Product.ItemDetail`
- 请求示例：
```json
@@ -621,7 +597,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemDetailBySerial`
- gRPC：`/mall.Product/ItemDetailBySerial`
- 白名单键：`mall.Product.ItemDetailBySerial`
- 请求示例：
```json
@@ -637,7 +612,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemDetailBySpec`
- gRPC：`/mall.Product/ItemDetailBySpec`
- 白名单键：`mall.Product.ItemDetailBySpec`
- 请求示例：
```json
@@ -650,7 +624,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemCreate`
- gRPC：`/mall.Product/ItemCreate`
- 白名单键：`mall.Product.ItemCreate`
- 请求示例：
```json
@@ -749,7 +722,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemDelete`
- gRPC：`/mall.Product/ItemDelete`
- 白名单键：`mall.Product.ItemDelete`
- 请求示例：
```json
@@ -763,7 +735,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemModify`
- gRPC：`/mall.Product/ItemModify`
- 白名单键：`mall.Product.ItemModify`
- 请求示例：
```json
@@ -777,7 +748,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/ItemBatchOp`
- gRPC：`/mall.Product/ItemBatchOp`
- 白名单键：`mall.Product.ItemBatchOp`
- 请求示例：
```json
@@ -793,7 +763,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/SpecFetch`
- gRPC：`/mall.Product/SpecFetch`
- 白名单键：`mall.Product.SpecFetch`
- 请求示例：
```json
@@ -818,7 +787,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/SpecCreate`
- gRPC：`/mall.Product/SpecCreate`
- 白名单键：`mall.Product.SpecCreate`
- 请求示例：
```json
@@ -847,7 +815,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/SpecModify`
- gRPC：`/mall.Product/SpecModify`
- 白名单键：`mall.Product.SpecModify`
- 请求示例：
```json
@@ -876,7 +843,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/SpecDelete`
- gRPC：`/mall.Product/SpecDelete`
- 白名单键：`mall.Product.SpecDelete`
- 请求示例：
```json
@@ -890,7 +856,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/SpecDetail`
- gRPC：`/mall.Product/SpecDetail`
- 白名单键：`mall.Product.SpecDetail`
- 请求示例：
```json
@@ -904,7 +869,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/PhotoCreate`
- gRPC：`/mall.Product/PhotoCreate`
- 白名单键：`mall.Product.PhotoCreate`
- 请求示例：
```json
@@ -923,7 +887,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/PhotoDelete`
- gRPC：`/mall.Product/PhotoDelete`
- 白名单键：`mall.Product.PhotoDelete`
- 请求示例：
```json
@@ -937,7 +900,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/PhotoList`
- gRPC：`/mall.Product/PhotoList`
- 白名单键：`mall.Product.PhotoList`
- 请求示例：
```json
@@ -956,7 +918,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/CommentFetch`
- gRPC：`/mall.Product/CommentFetch`
- 白名单键：`mall.Product.CommentFetch`
- 请求示例：
```json
@@ -981,7 +942,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/CommentCreate`
- gRPC：`/mall.Product/CommentCreate`
- 白名单键：`mall.Product.CommentCreate`
- 请求示例：
```json
@@ -1007,7 +967,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/CommentRe`
- gRPC：`/mall.Product/CommentRe`
- 白名单键：`mall.Product.CommentRe`
- 请求示例：
```json
@@ -1033,7 +992,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/CommentDelete`
- gRPC：`/mall.Product/CommentDelete`
- 白名单键：`mall.Product.CommentDelete`
- 请求示例：
```json
@@ -1047,7 +1005,6 @@
- 动态 HTTP：`POST /rpc/mall/Product/CommentModify`
- gRPC：`/mall.Product/CommentModify`
- 白名单键：`mall.Product.CommentModify`
- 请求示例：
```json
@@ -1085,7 +1042,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/Login`
- gRPC：`/mall.Staff/Login`
- 白名单键：`mall.Staff.Login`
- 请求示例：
```json
@@ -1102,7 +1058,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/Fetch`
- gRPC：`/mall.Staff/Fetch`
- 白名单键：`mall.Staff.Fetch`
- 请求示例：
```json
@@ -1127,7 +1082,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/Create`
- gRPC：`/mall.Staff/Create`
- 白名单键：`mall.Staff.Create`
- 请求示例：
```json
@@ -1151,7 +1105,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/Delete`
- gRPC：`/mall.Staff/Delete`
- 白名单键：`mall.Staff.Delete`
- 请求示例：
```json
@@ -1165,7 +1118,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/GetProfile`
- gRPC：`/mall.Staff/GetProfile`
- 白名单键：`mall.Staff.GetProfile`
- 请求示例：
```json
@@ -1179,7 +1131,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/SetProfile`
- gRPC：`/mall.Staff/SetProfile`
- 白名单键：`mall.Staff.SetProfile`
- 请求示例：
```json
@@ -1203,7 +1154,6 @@
- 动态 HTTP：`POST /rpc/mall/Staff/SetPassword`
- gRPC：`/mall.Staff/SetPassword`
- 白名单键：`mall.Staff.SetPassword`
- 请求示例：
```json
@@ -1233,7 +1183,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/ApplyJoin`
- gRPC：`/mall.Store/ApplyJoin`
- 白名单键：`mall.Store.ApplyJoin`
- 请求示例：
```json
@@ -1257,7 +1206,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/Licensing`
- gRPC：`/mall.Store/Licensing`
- 白名单键：`mall.Store.Licensing`
- 请求示例：
```json
@@ -1274,7 +1222,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/GetSetting`
- gRPC：`/mall.Store/GetSetting`
- 白名单键：`mall.Store.GetSetting`
- 请求示例：
```json
@@ -1288,7 +1235,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/SetSetting`
- gRPC：`/mall.Store/SetSetting`
- 白名单键：`mall.Store.SetSetting`
- 请求示例：
```json
@@ -1312,7 +1258,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/SetPayment`
- gRPC：`/mall.Store/SetPayment`
- 白名单键：`mall.Store.SetPayment`
- 请求示例：
```json
@@ -1326,7 +1271,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/SetEmail`
- gRPC：`/mall.Store/SetEmail`
- 白名单键：`mall.Store.SetEmail`
- 请求示例：
```json
@@ -1340,7 +1284,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/GetPayment`
- gRPC：`/mall.Store/GetPayment`
- 白名单键：`mall.Store.GetPayment`
- 请求示例：
```json
@@ -1354,7 +1297,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/GetEmail`
- gRPC：`/mall.Store/GetEmail`
- 白名单键：`mall.Store.GetEmail`
- 请求示例：
```json
@@ -1368,7 +1310,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/MiniCode`
- gRPC：`/mall.Store/MiniCode`
- 白名单键：`mall.Store.MiniCode`
- 请求示例：
```json
@@ -1381,7 +1322,6 @@
- 动态 HTTP：`POST /rpc/mall/Store/Search`
- gRPC：`/mall.Store/Search`
- 白名单键：`mall.Store.Search`
- 请求示例：
```json

21
wiki/api/10-market.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/market/{Service}/{Method}`
- 原生 gRPC：`/market.{Service}/{Method}`
- grpc-gateway：`POST /market.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -38,7 +38,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Login`
- gRPC：`/market.Agency/Login`
- 白名单键：`market.Agency.Login`
- 请求示例：
```json
@@ -53,7 +52,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Create`
- gRPC：`/market.Agency/Create`
- 白名单键：`market.Agency.Create`
- 请求示例：
```json
@@ -85,7 +83,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Get`
- gRPC：`/market.Agency/Get`
- 白名单键：`market.Agency.Get`
- 请求示例：
```json
@@ -99,7 +96,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Fetch`
- gRPC：`/market.Agency/Fetch`
- 白名单键：`market.Agency.Fetch`
- 请求示例：
```json
@@ -120,7 +116,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Modify`
- gRPC：`/market.Agency/Modify`
- 白名单键：`market.Agency.Modify`
- 请求示例：
```json
@@ -152,7 +147,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Delete`
- gRPC：`/market.Agency/Delete`
- 白名单键：`market.Agency.Delete`
- 请求示例：
```json
@@ -166,7 +160,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/SetPassword`
- gRPC：`/market.Agency/SetPassword`
- 白名单键：`market.Agency.SetPassword`
- 请求示例：
```json
@@ -181,7 +174,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Pending`
- gRPC：`/market.Agency/Pending`
- 白名单键：`market.Agency.Pending`
- 请求示例：
```json
@@ -202,7 +194,6 @@
- 动态 HTTP：`POST /rpc/market/Agency/Approve`
- gRPC：`/market.Agency/Approve`
- 白名单键：`market.Agency.Approve`
- 请求示例：
```json
@@ -226,7 +217,6 @@
- 动态 HTTP：`POST /rpc/market/Data/Overview`
- gRPC：`/market.Data/Overview`
- 白名单键：`market.Data.Overview`
- 请求示例：
```json
@@ -237,7 +227,6 @@
- 动态 HTTP：`POST /rpc/market/Data/MemberFetch`
- gRPC：`/market.Data/MemberFetch`
- 白名单键：`market.Data.MemberFetch`
- 请求示例：
```json
@@ -258,7 +247,6 @@
- 动态 HTTP：`POST /rpc/market/Data/MemberDetails`
- gRPC：`/market.Data/MemberDetails`
- 白名单键：`market.Data.MemberDetails`
- 请求示例：
```json
@@ -272,7 +260,6 @@
- 动态 HTTP：`POST /rpc/market/Data/OrderFetch`
- gRPC：`/market.Data/OrderFetch`
- 白名单键：`market.Data.OrderFetch`
- 请求示例：
```json
@@ -293,7 +280,6 @@
- 动态 HTTP：`POST /rpc/market/Data/OrderDetails`
- gRPC：`/market.Data/OrderDetails`
- 白名单键：`market.Data.OrderDetails`
- 请求示例：
```json
@@ -317,7 +303,6 @@
- 动态 HTTP：`POST /rpc/market/Supply/Create`
- gRPC：`/market.Supply/Create`
- 白名单键：`market.Supply.Create`
- 请求示例：
```json
@@ -344,7 +329,6 @@
- 动态 HTTP：`POST /rpc/market/Supply/Get`
- gRPC：`/market.Supply/Get`
- 白名单键：`market.Supply.Get`
- 请求示例：
```json
@@ -358,7 +342,6 @@
- 动态 HTTP：`POST /rpc/market/Supply/Fetch`
- gRPC：`/market.Supply/Fetch`
- 白名单键：`market.Supply.Fetch`
- 请求示例：
```json
@@ -379,7 +362,6 @@
- 动态 HTTP：`POST /rpc/market/Supply/Modify`
- gRPC：`/market.Supply/Modify`
- 白名单键：`market.Supply.Modify`
- 请求示例：
```json
@@ -406,7 +388,6 @@
- 动态 HTTP：`POST /rpc/market/Supply/Delete`
- gRPC：`/market.Supply/Delete`
- 白名单键：`market.Supply.Delete`
- 请求示例：
```json

24
wiki/api/11-order.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/order/{Service}/{Method}`
- 原生 gRPC：`/order.{Service}/{Method}`
- grpc-gateway：`POST /order.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -34,7 +34,6 @@
- 动态 HTTP：`POST /rpc/order/Cart/Fetch`
- gRPC：`/order.Cart/Fetch`
- 白名单键：`order.Cart.Fetch`
- 请求示例：
```json
@@ -49,7 +48,6 @@
- 动态 HTTP：`POST /rpc/order/Cart/Create`
- gRPC：`/order.Cart/Create`
- 白名单键：`order.Cart.Create`
- 请求示例：
```json
@@ -68,7 +66,6 @@
- 动态 HTTP：`POST /rpc/order/Cart/Modify`
- gRPC：`/order.Cart/Modify`
- 白名单键：`order.Cart.Modify`
- 请求示例：
```json
@@ -90,7 +87,6 @@
- 动态 HTTP：`POST /rpc/order/Cart/Delete`
- gRPC：`/order.Cart/Delete`
- 白名单键：`order.Cart.Delete`
- 请求示例：
```json
@@ -111,7 +107,6 @@
- 动态 HTTP：`POST /rpc/order/Coupon/ByStatus`
- gRPC：`/order.Coupon/ByStatus`
- 白名单键：`order.Coupon.ByStatus`
- 请求示例：
```json
@@ -136,7 +131,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderCreate`
- gRPC：`/order.Mgt/OrderCreate`
- 白名单键：`order.Mgt.OrderCreate`
- 请求示例：
```json
@@ -158,7 +152,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderModify`
- gRPC：`/order.Mgt/OrderModify`
- 白名单键：`order.Mgt.OrderModify`
- 请求示例：
```json
@@ -227,7 +220,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderGet`
- gRPC：`/order.Mgt/OrderGet`
- 白名单键：`order.Mgt.OrderGet`
- 请求示例：
```json
@@ -245,7 +237,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderListByStore`
- gRPC：`/order.Mgt/OrderListByStore`
- 白名单键：`order.Mgt.OrderListByStore`
- 请求示例：
```json
@@ -268,7 +259,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderCancel`
- gRPC：`/order.Mgt/OrderCancel`
- 白名单键：`order.Mgt.OrderCancel`
- 请求示例：
```json
@@ -286,7 +276,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderReturnable`
- gRPC：`/order.Mgt/OrderReturnable`
- 白名单键：`order.Mgt.OrderReturnable`
- 请求示例：
```json
@@ -304,7 +293,6 @@
- 动态 HTTP：`POST /rpc/order/Mgt/OrderApprove`
- gRPC：`/order.Mgt/OrderApprove`
- 白名单键：`order.Mgt.OrderApprove`
- 请求示例：
```json
@@ -337,7 +325,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/QuickCreateByProduct`
- gRPC：`/order.Summary/QuickCreateByProduct`
- 白名单键：`order.Summary.QuickCreateByProduct`
- 请求示例：
```json
@@ -359,7 +346,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/Submit`
- gRPC：`/order.Summary/Submit`
- 白名单键：`order.Summary.Submit`
- 请求示例：
```json
@@ -389,7 +375,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/Check`
- gRPC：`/order.Summary/Check`
- 白名单键：`order.Summary.Check`
- 请求示例：
```json
@@ -400,7 +385,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/Get`
- gRPC：`/order.Summary/Get`
- 白名单键：`order.Summary.Get`
- 请求示例：
```json
@@ -418,7 +402,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/List`
- gRPC：`/order.Summary/List`
- 白名单键：`order.Summary.List`
- 请求示例：
```json
@@ -434,7 +417,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/Confirm`
- gRPC：`/order.Summary/Confirm`
- 白名单键：`order.Summary.Confirm`
- 请求示例：
```json
@@ -451,7 +433,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/Cancel`
- gRPC：`/order.Summary/Cancel`
- 白名单键：`order.Summary.Cancel`
- 请求示例：
```json
@@ -465,7 +446,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/SimulatePay`
- gRPC：`/order.Summary/SimulatePay`
- 白名单键：`order.Summary.SimulatePay`
- 请求示例：
```json
@@ -480,7 +460,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/SimulateShipments`
- gRPC：`/order.Summary/SimulateShipments`
- 白名单键：`order.Summary.SimulateShipments`
- 请求示例：
```json
@@ -496,7 +475,6 @@
- 动态 HTTP：`POST /rpc/order/Summary/SimulateReceiving`
- gRPC：`/order.Summary/SimulateReceiving`
- 白名单键：`order.Summary.SimulateReceiving`
- 请求示例：
```json

25
wiki/api/12-wallet.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/wallet/{Service}/{Method}`
- 原生 gRPC：`/wallet.{Service}/{Method}`
- grpc-gateway：`POST /wallet.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -34,7 +34,6 @@
- 动态 HTTP：`POST /rpc/wallet/Alipay/WapPay`
- gRPC：`/wallet.Alipay/WapPay`
- 白名单键：`wallet.Alipay.WapPay`
- 请求示例：
```json
@@ -51,7 +50,6 @@
- 动态 HTTP：`POST /rpc/wallet/Alipay/PagePay`
- gRPC：`/wallet.Alipay/PagePay`
- 白名单键：`wallet.Alipay.PagePay`
- 请求示例：
```json
@@ -68,7 +66,6 @@
- 动态 HTTP：`POST /rpc/wallet/Alipay/AppPay`
- gRPC：`/wallet.Alipay/AppPay`
- 白名单键：`wallet.Alipay.AppPay`
- 请求示例：
```json
@@ -84,7 +81,6 @@
- 动态 HTTP：`POST /rpc/wallet/Alipay/Transfer`
- gRPC：`/wallet.Alipay/Transfer`
- 白名单键：`wallet.Alipay.Transfer`
- 请求示例：
```json
@@ -113,7 +109,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/GetWallet`
- gRPC：`/wallet.Basic/GetWallet`
- 白名单键：`wallet.Basic.GetWallet`
- 请求示例：
```json
@@ -131,7 +126,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/SetPayPassword`
- gRPC：`/wallet.Basic/SetPayPassword`
- 白名单键：`wallet.Basic.SetPayPassword`
- 请求示例：
```json
@@ -145,7 +139,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/BindPaymentId`
- gRPC：`/wallet.Basic/BindPaymentId`
- 白名单键：`wallet.Basic.BindPaymentId`
- 请求示例：
```json
@@ -159,7 +152,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/Transactions`
- gRPC：`/wallet.Basic/Transactions`
- 白名单键：`wallet.Basic.Transactions`
- 请求示例：
```json
@@ -177,7 +169,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/AddBankCard`
- gRPC：`/wallet.Basic/AddBankCard`
- 白名单键：`wallet.Basic.AddBankCard`
- 请求示例：
```json
@@ -194,7 +185,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/GetBankCard`
- gRPC：`/wallet.Basic/GetBankCard`
- 白名单键：`wallet.Basic.GetBankCard`
- 请求示例：
```json
@@ -205,7 +195,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/RmBankCard`
- gRPC：`/wallet.Basic/RmBankCard`
- 白名单键：`wallet.Basic.RmBankCard`
- 请求示例：
```json
@@ -218,7 +207,6 @@
- 动态 HTTP：`POST /rpc/wallet/Basic/ApplyCash`
- gRPC：`/wallet.Basic/ApplyCash`
- 白名单键：`wallet.Basic.ApplyCash`
- 请求示例：
```json
@@ -244,7 +232,6 @@
- 动态 HTTP：`POST /rpc/wallet/Payment/Hello`
- gRPC：`/wallet.Payment/Hello`
- 白名单键：`wallet.Payment.Hello`
- 请求示例：
```json
@@ -255,7 +242,6 @@
- 动态 HTTP：`POST /rpc/wallet/Payment/Way`
- gRPC：`/wallet.Payment/Way`
- 白名单键：`wallet.Payment.Way`
- 请求示例：
```json
@@ -268,7 +254,6 @@
- 动态 HTTP：`POST /rpc/wallet/Payment/Get`
- gRPC：`/wallet.Payment/Get`
- 白名单键：`wallet.Payment.Get`
- 请求示例：
```json
@@ -282,7 +267,6 @@
- 动态 HTTP：`POST /rpc/wallet/Payment/ByOrder`
- gRPC：`/wallet.Payment/ByOrder`
- 白名单键：`wallet.Payment.ByOrder`
- 请求示例：
```json
@@ -301,7 +285,6 @@
- 动态 HTTP：`POST /rpc/wallet/Payment/ByCharge`
- gRPC：`/wallet.Payment/ByCharge`
- 白名单键：`wallet.Payment.ByCharge`
- 请求示例：
```json
@@ -319,7 +302,6 @@
- 动态 HTTP：`POST /rpc/wallet/Payment/Callback`
- gRPC：`/wallet.Payment/Callback`
- 白名单键：`wallet.Payment.Callback`
- 请求示例：
```json
@@ -345,7 +327,6 @@
- 动态 HTTP：`POST /rpc/wallet/Wechat/JsapiPreOrder`
- gRPC：`/wallet.Wechat/JsapiPreOrder`
- 白名单键：`wallet.Wechat.JsapiPreOrder`
- 请求示例：
```json
@@ -363,7 +344,6 @@
- 动态 HTTP：`POST /rpc/wallet/Wechat/AppPreOrder`
- gRPC：`/wallet.Wechat/AppPreOrder`
- 白名单键：`wallet.Wechat.AppPreOrder`
- 请求示例：
```json
@@ -379,7 +359,6 @@
- 动态 HTTP：`POST /rpc/wallet/Wechat/NativePreOrder`
- gRPC：`/wallet.Wechat/NativePreOrder`
- 白名单键：`wallet.Wechat.NativePreOrder`
- 请求示例：
```json
@@ -395,7 +374,6 @@
- 动态 HTTP：`POST /rpc/wallet/Wechat/Transfer`
- gRPC：`/wallet.Wechat/Transfer`
- 白名单键：`wallet.Wechat.Transfer`
- 请求示例：
```json
@@ -412,7 +390,6 @@
- 动态 HTTP：`POST /rpc/wallet/Wechat/WxCallback`
- gRPC：`/wallet.Wechat/WxCallback`
- 白名单键：`wallet.Wechat.WxCallback`
- 请求示例：
```json

19
wiki/api/13-feed.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/feed/{Service}/{Method}`
- 原生 gRPC：`/feed.{Service}/{Method}`
- grpc-gateway：`POST /feed.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -38,7 +38,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/Fetch`
- gRPC：`/feed.Post/Fetch`
- 白名单键：`feed.Post.Fetch`
- 请求示例：
```json
@@ -55,7 +54,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/Create`
- gRPC：`/feed.Post/Create`
- 白名单键：`feed.Post.Create`
- 请求示例：
```json
@@ -88,7 +86,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/Change`
- gRPC：`/feed.Post/Change`
- 白名单键：`feed.Post.Change`
- 请求示例：
```json
@@ -121,7 +118,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/Remove`
- gRPC：`/feed.Post/Remove`
- 白名单键：`feed.Post.Remove`
- 请求示例：
```json
@@ -135,7 +131,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/CommentList`
- gRPC：`/feed.Post/CommentList`
- 白名单键：`feed.Post.CommentList`
- 请求示例：
```json
@@ -152,7 +147,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/AddComment`
- gRPC：`/feed.Post/AddComment`
- 白名单键：`feed.Post.AddComment`
- 请求示例：
```json
@@ -171,7 +165,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/DeleteComment`
- gRPC：`/feed.Post/DeleteComment`
- 白名单键：`feed.Post.DeleteComment`
- 请求示例：
```json
@@ -185,7 +178,6 @@
- 动态 HTTP：`POST /rpc/feed/Post/Action`
- gRPC：`/feed.Post/Action`
- 白名单键：`feed.Post.Action`
- 请求示例：
```json
@@ -207,7 +199,6 @@
- 动态 HTTP：`POST /rpc/feed/Setting/Info`
- gRPC：`/feed.Setting/Info`
- 白名单键：`feed.Setting.Info`
- 请求示例：
```json
@@ -218,7 +209,6 @@
- 动态 HTTP：`POST /rpc/feed/Setting/Rights`
- gRPC：`/feed.Setting/Rights`
- 白名单键：`feed.Setting.Rights`
- 请求示例：
```json
@@ -237,7 +227,6 @@
- 动态 HTTP：`POST /rpc/feed/Tag/List`
- gRPC：`/feed.Tag/List`
- 白名单键：`feed.Tag.List`
- 请求示例：
```json
@@ -254,7 +243,6 @@
- 动态 HTTP：`POST /rpc/feed/Tag/Create`
- gRPC：`/feed.Tag/Create`
- 白名单键：`feed.Tag.Create`
- 请求示例：
```json
@@ -269,7 +257,6 @@
- 动态 HTTP：`POST /rpc/feed/Tag/PostList`
- gRPC：`/feed.Tag/PostList`
- 白名单键：`feed.Tag.PostList`
- 请求示例：
```json
@@ -295,7 +282,6 @@
- 动态 HTTP：`POST /rpc/feed/Timeline/Recommend`
- gRPC：`/feed.Timeline/Recommend`
- 白名单键：`feed.Timeline.Recommend`
- 请求示例：
```json
@@ -312,7 +298,6 @@
- 动态 HTTP：`POST /rpc/feed/Timeline/Friend`
- gRPC：`/feed.Timeline/Friend`
- 白名单键：`feed.Timeline.Friend`
- 请求示例：
```json
@@ -329,7 +314,6 @@
- 动态 HTTP：`POST /rpc/feed/Timeline/Follow`
- gRPC：`/feed.Timeline/Follow`
- 白名单键：`feed.Timeline.Follow`
- 请求示例：
```json
@@ -346,7 +330,6 @@
- 动态 HTTP：`POST /rpc/feed/Timeline/Hot`
- gRPC：`/feed.Timeline/Hot`
- 白名单键：`feed.Timeline.Hot`
- 请求示例：
```json

15
wiki/api/14-group.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/group/{Service}/{Method}`
- 原生 gRPC：`/group.{Service}/{Method}`
- grpc-gateway：`POST /group.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -34,7 +34,6 @@
- 动态 HTTP：`POST /rpc/group/Basic/Search`
- gRPC：`/group.Basic/Search`
- 白名单键：`group.Basic.Search`
- 请求示例：
```json
@@ -47,7 +46,6 @@
- 动态 HTTP：`POST /rpc/group/Basic/Fetch`
- gRPC：`/group.Basic/Fetch`
- 白名单键：`group.Basic.Fetch`
- 请求示例：
```json
@@ -58,7 +56,6 @@
- 动态 HTTP：`POST /rpc/group/Basic/Get`
- gRPC：`/group.Basic/Get`
- 白名单键：`group.Basic.Get`
- 请求示例：
```json
@@ -72,7 +69,6 @@
- 动态 HTTP：`POST /rpc/group/Basic/Create`
- gRPC：`/group.Basic/Create`
- 白名单键：`group.Basic.Create`
- 请求示例：
```json
@@ -105,7 +101,6 @@
- 动态 HTTP：`POST /rpc/group/Basic/Modify`
- gRPC：`/group.Basic/Modify`
- 白名单键：`group.Basic.Modify`
- 请求示例：
```json
@@ -138,7 +133,6 @@
- 动态 HTTP：`POST /rpc/group/Basic/Disband`
- gRPC：`/group.Basic/Disband`
- 白名单键：`group.Basic.Disband`
- 请求示例：
```json
@@ -164,7 +158,6 @@
- 动态 HTTP：`POST /rpc/group/Member/Fetch`
- gRPC：`/group.Member/Fetch`
- 白名单键：`group.Member.Fetch`
- 请求示例：
```json
@@ -178,7 +171,6 @@
- 动态 HTTP：`POST /rpc/group/Member/DoJoin`
- gRPC：`/group.Member/DoJoin`
- 白名单键：`group.Member.DoJoin`
- 请求示例：
```json
@@ -193,7 +185,6 @@
- 动态 HTTP：`POST /rpc/group/Member/JoinFetch`
- gRPC：`/group.Member/JoinFetch`
- 白名单键：`group.Member.JoinFetch`
- 请求示例：
```json
@@ -204,7 +195,6 @@
- 动态 HTTP：`POST /rpc/group/Member/JoinDoHandle`
- gRPC：`/group.Member/JoinDoHandle`
- 白名单键：`group.Member.JoinDoHandle`
- 请求示例：
```json
@@ -219,7 +209,6 @@
- 动态 HTTP：`POST /rpc/group/Member/DoSetManager`
- gRPC：`/group.Member/DoSetManager`
- 白名单键：`group.Member.DoSetManager`
- 请求示例：
```json
@@ -234,7 +223,6 @@
- 动态 HTTP：`POST /rpc/group/Member/DoKick`
- gRPC：`/group.Member/DoKick`
- 白名单键：`group.Member.DoKick`
- 请求示例：
```json
@@ -249,7 +237,6 @@
- 动态 HTTP：`POST /rpc/group/Member/DoQuit`
- gRPC：`/group.Member/DoQuit`
- 白名单键：`group.Member.DoQuit`
- 请求示例：
```json

27
wiki/api/15-relation.md
View File

@@ -9,7 +9,7 @@
- 动态 HTTP：`POST /rpc/relation/{Service}/{Method}`
- 原生 gRPC：`/relation.{Service}/{Method}`
- grpc-gateway：`POST /relation.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: Bearer <token>` 传递凭证。
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。
## 服务概览
@@ -33,7 +33,6 @@
- 动态 HTTP：`POST /rpc/relation/Follow/Doing`
- gRPC：`/relation.Follow/Doing`
- 白名单键：`relation.Follow.Doing`
- 请求示例：
```json
@@ -47,7 +46,6 @@
- 动态 HTTP：`POST /rpc/relation/Follow/Undo`
- gRPC：`/relation.Follow/Undo`
- 白名单键：`relation.Follow.Undo`
- 请求示例：
```json
@@ -61,7 +59,6 @@
- 动态 HTTP：`POST /rpc/relation/Follow/State`
- gRPC：`/relation.Follow/State`
- 白名单键：`relation.Follow.State`
- 请求示例：
```json
@@ -75,7 +72,6 @@
- 动态 HTTP：`POST /rpc/relation/Follow/Fetch`
- gRPC：`/relation.Follow/Fetch`
- 白名单键：`relation.Follow.Fetch`
- 请求示例：
```json
@@ -114,7 +110,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/Search`
- gRPC：`/relation.Friend/Search`
- 白名单键：`relation.Friend.Search`
- 请求示例：
```json
@@ -127,7 +122,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/Fetch`
- gRPC：`/relation.Friend/Fetch`
- 白名单键：`relation.Friend.Fetch`
- 请求示例：
```json
@@ -140,7 +134,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/Get`
- gRPC：`/relation.Friend/Get`
- 白名单键：`relation.Friend.Get`
- 请求示例：
```json
@@ -154,7 +147,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ModifyNickname`
- gRPC：`/relation.Friend/ModifyNickname`
- 白名单键：`relation.Friend.ModifyNickname`
- 请求示例：
```json
@@ -168,7 +160,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/DoPopular`
- gRPC：`/relation.Friend/DoPopular`
- 白名单键：`relation.Friend.DoPopular`
- 请求示例：
```json
@@ -182,7 +173,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/UndoPopular`
- gRPC：`/relation.Friend/UndoPopular`
- 白名单键：`relation.Friend.UndoPopular`
- 请求示例：
```json
@@ -196,7 +186,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/Delete`
- gRPC：`/relation.Friend/Delete`
- 白名单键：`relation.Friend.Delete`
- 请求示例：
```json
@@ -210,7 +199,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ApplyFetch`
- gRPC：`/relation.Friend/ApplyFetch`
- 白名单键：`relation.Friend.ApplyFetch`
- 请求示例：
```json
@@ -223,7 +211,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ApplyGet`
- gRPC：`/relation.Friend/ApplyGet`
- 白名单键：`relation.Friend.ApplyGet`
- 请求示例：
```json
@@ -237,7 +224,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ApplyDo`
- gRPC：`/relation.Friend/ApplyDo`
- 白名单键：`relation.Friend.ApplyDo`
- 请求示例：
```json
@@ -252,7 +238,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ApplyDoMessage`
- gRPC：`/relation.Friend/ApplyDoMessage`
- 白名单键：`relation.Friend.ApplyDoMessage`
- 请求示例：
```json
@@ -266,7 +251,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ApplyDoPass`
- gRPC：`/relation.Friend/ApplyDoPass`
- 白名单键：`relation.Friend.ApplyDoPass`
- 请求示例：
```json
@@ -281,7 +265,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/ApplyDoReject`
- gRPC：`/relation.Friend/ApplyDoReject`
- 白名单键：`relation.Friend.ApplyDoReject`
- 请求示例：
```json
@@ -295,7 +278,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/TagFetch`
- gRPC：`/relation.Friend/TagFetch`
- 白名单键：`relation.Friend.TagFetch`
- 请求示例：
```json
@@ -306,7 +288,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/TagMemberFetch`
- gRPC：`/relation.Friend/TagMemberFetch`
- 白名单键：`relation.Friend.TagMemberFetch`
- 请求示例：
```json
@@ -320,7 +301,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/TagDoCreate`
- gRPC：`/relation.Friend/TagDoCreate`
- 白名单键：`relation.Friend.TagDoCreate`
- 请求示例：
```json
@@ -336,7 +316,6 @@
- 动态 HTTP：`POST /rpc/relation/Friend/TagDoUpdate`
- gRPC：`/relation.Friend/TagDoUpdate`
- 白名单键：`relation.Friend.TagDoUpdate`
- 请求示例：
```json
@@ -360,7 +339,6 @@
- 动态 HTTP：`POST /rpc/relation/Match/Fetch`
- gRPC：`/relation.Match/Fetch`
- 白名单键：`relation.Match.Fetch`
- 请求示例：
```json
@@ -377,7 +355,6 @@
- 动态 HTTP：`POST /rpc/relation/Match/Get`
- gRPC：`/relation.Match/Get`
- 白名单键：`relation.Match.Get`
- 请求示例：
```json
@@ -391,7 +368,6 @@
- 动态 HTTP：`POST /rpc/relation/Match/DoJoin`
- gRPC：`/relation.Match/DoJoin`
- 白名单键：`relation.Match.DoJoin`
- 请求示例：
```json
@@ -405,7 +381,6 @@
- 动态 HTTP：`POST /rpc/relation/Match/DoIgnore`
- gRPC：`/relation.Match/DoIgnore`
- 白名单键：`relation.Match.DoIgnore`
- 请求示例：
```json

4
wiki/api/16-fts-rest.md
View File

@@ -8,13 +8,13 @@
|---|---|---|---|---|
| GET | `/rest/fts/ping` | 否 | 无 | 健康检查，返回 Pong |
| GET | `/rest/fts/config` | 否 | 无 | 获取上传字段、大小和扩展名限制 |
| POST | `/rest/fts/uploader` | Bearer Token | `multipart/form-data` | 上传文件到 local 或 MinIO |
| POST | `/rest/fts/uploader` | JWT | `multipart/form-data` | 上传文件到 local 或 MinIO |
## 上传文件
```http
POST /rest/fts/uploader
Authorization: Bearer <token>
Authorization: <JWT>
Content-Type: multipart/form-data
```

3
wiki/api/18-mgt-rest.md
View File

@@ -1,6 +1,6 @@
# MGT REST API
后台用户、应用、角色、权限和部门管理。基础路径：`/rest/mgt`。除匿名接口外均需 Bearer Token；标记“管理员”的路由还会执行管理员权限检查。
后台用户、应用、角色、权限和部门管理。基础路径：`/rest/mgt`。除匿名接口外均需在 `Authorization` 头直接携带 JWT（不加 `Bearer`）；标记“管理员”的路由还会执行管理员权限检查。
## 匿名接口
@@ -129,4 +129,3 @@
## 通用响应
接口使用 SDK 统一响应包装，常见数据结构包括：登录 `LoginResp`、分页 `{total,data,page,size}`、创建 `{id,identity}`。客户端必须同时判断 HTTP 状态和响应中的业务 code。