这是一个为MSR API提供Rust封装的库，支持直接API调用以及可选的Swagger UI文档。
- 核心API封装：完整的MSR API功能封装，可直接调用
- 可选Swagger UI：通过feature控制是否启用Swagger文档界面
- 类型安全：完整的DTO类型定义
这是最主要的使用方式，可以直接在其他库或应用中调用API：
use easy_msr_api::client::remote::RemoteApiClient;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// 创建API客户端
let client = RemoteApiClient::new("https://monster-siren.hypergryph.com/api".to_string());
// 直接调用API方法 - 无需Web路由
let song = client.get_song("123456".to_string()).await?;
println!("歌曲名称: {}", song.data.name);
let albums = client.get_all_albums().await?;
println!("专辑数量: {}", albums.data.len());
let search_result = client.search("关键词".to_string()).await?;
println!("搜索结果: {} 个专辑, {} 条新闻",
search_result.data.albums.list.len(),
search_result.data.news.list.len());
Ok(())
}use easy_msr_api::{client::remote::RemoteApiClient, web};
let client = RemoteApiClient::new("https://monster-siren.hypergryph.com/api".to_string());
let app = web::routes_with_swagger(client); // 需要启用swagger-ui featurecargo run --features web --bin serverclient.get_song(id: String) -> Result<SongResp, AppError>client.get_all_songs() -> Result<AllSongsResp, AppError>
client.get_album(id: String) -> Result<AlbumResp, AppError>client.get_album_detail(id: String) -> Result<AlbumDetailResp, AppError>client.get_all_albums() -> Result<ApiResp<Vec<AllAlbumsItem>>, AppError>
client.get_all_news(last_cid: Option<String>) -> Result<SearchNewsResp, AppError>client.get_news_detail(id: String) -> Result<NewsDetailResp, AppError>
client.search(keyword: String) -> Result<SearchResp, AppError>client.search_albums(keyword: String, last_cid: Option<String>) -> Result<SearchAlbumResp, AppError>client.search_news(keyword: String, last_cid: Option<String>) -> Result<SearchNewsResp, AppError>
client.get_font() -> Result<FontResp, AppError>
- default: 无额外功能，仅包含核心API封装
- web: 启用Swagger UI界面支持（用于Web服务）
easy-msr-api
├── Cargo.lock
├── Cargo.toml
├── examples # 示例项目
│ ├── easy-msr-api-hello-lib # 作为lib使用
│ │ ├── Cargo.toml
│ │ └── src
│ │ └── main.rs
│ └── easy-msr-api-hello-swagger-ui # 作为swagger-ui使用
│ ├── Cargo.toml
│ └── src
│ └── main.rs
├── README.md
└── src
├── bin # 启动swagger-ui
│ └── server.rs
├── client # api封装
│ └── remote.rs
├── client.rs
├── config.rs # 配置管理
├── dto.rs # 相应、查询结构体
├── error.rs # 错误处理
├── lib.rs
├── web # web处理
│ ├── docs.rs # OpenAPI文档
│ └── handler.rs # 请求处理器
└── web.rs
创建.env文件：
SERVER_PORT=8080
REMOTE_BASE=https://monster-siren.hypergryph.com/api- 添加到Cargo.toml：
[dependencies]
easy-msr-api = "0.1.0"- 直接API调用：
use easy_msr_api::client::remote::RemoteApiClient;
let client = RemoteApiClient::new("https://monster-siren.hypergryph.com/api".to_string());
let song = client.get_song("123456".to_string()).await?;- Web服务（可选）：
use easy_msr_api::{client::remote::RemoteApiClient, web};
let client = RemoteApiClient::new("https://monster-siren.hypergryph.com/api".to_string());
let app = web::routes(client);