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

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