Struct RemoteApiClient 

pub struct RemoteApiClient { /* private fields */ }

远程API客户端

封装了HTTP客户端和API基础URL，提供所有MSR API的调用方法。 支持自定义超时时间和基础URL配置。

Implementations

impl RemoteApiClient

pub fn new(base: String) -> Self

创建默认配置的客户端

使用30秒的超时时间和默认的用户代理字符串。

参数

• base - API的基础URL地址

示例

use easy_msr_api::client::remote::RemoteApiClient;
 
let client = RemoteApiClient::new("https://monster-siren.hypergryph.com/api".to_string());

pub fn with_config(base: String, timeout: Duration) -> Self

使用自定义超时时间创建客户端

参数

• base - API的基础URL地址
• timeout - HTTP请求超时时间

示例

use std::time::Duration;
use easy_msr_api::client::remote::RemoteApiClient;
 
let client = RemoteApiClient::with_config(
    "https://monster-siren.hypergryph.com/api".to_string(),
    Duration::from_secs(60)
);

pub async fn get_song(&self, id: String) -> Result<SongResp, AppError>

获取指定ID的歌曲详情

参数

• id - 歌曲的唯一标识符（cid）

返回

返回包含歌曲详细信息的响应

pub async fn get_all_songs(&self) -> Result<AllSongsResp, AppError>

获取所有歌曲列表

返回

返回包含所有歌曲基本信息的列表

pub async fn get_album(&self, id: String) -> Result<AlbumResp, AppError>

获取指定ID的专辑信息

参数

• id - 专辑的唯一标识符（cid）

返回

返回包含专辑详细信息的响应

pub async fn get_album_detail( &self, id: String, ) -> Result<AlbumDetailResp, AppError>

获取指定ID的专辑详情（包含歌曲列表）

参数

• id - 专辑的唯一标识符（cid）

返回

返回包含专辑详情和歌曲列表的响应

pub async fn get_all_albums( &self, ) -> Result<ApiResp<Vec<AllAlbumsItem>>, AppError>

获取所有专辑列表

返回

返回包含所有专辑基本信息的列表

pub async fn get_all_news( &self, last_cid: Option<String>, ) -> Result<SearchNewsResp, AppError>

获取所有新闻列表

参数

• last_cid - 可选参数，用于分页，从指定cid之后开始获取

返回

返回包含新闻列表的响应

pub async fn get_news_detail( &self, id: String, ) -> Result<NewsDetailResp, AppError>

获取指定ID的新闻详情

参数

• id - 新闻的唯一标识符（cid）

返回

返回包含新闻详细内容的响应

pub async fn get_font(&self) -> Result<FontResp, AppError>

获取字体配置信息

返回

返回包含字体文件URL配置的响应

pub async fn search(&self, keyword: String) -> Result<SearchResp, AppError>

综合搜索（同时搜索专辑和新闻）

参数

• keyword - 搜索关键词

返回

返回包含专辑和新闻搜索结果的响应

pub async fn search_albums( &self, keyword: String, last_cid: Option<String>, ) -> Result<SearchAlbumResp, AppError>

搜索专辑

参数

• keyword - 搜索关键词
• last_cid - 可选参数，用于分页

返回

返回包含专辑搜索结果的响应

pub async fn search_news( &self, keyword: String, last_cid: Option<String>, ) -> Result<SearchNewsResp, AppError>

搜索新闻

参数

• keyword - 搜索关键词
• last_cid - 可选参数，用于分页

返回

返回包含新闻搜索结果的响应

Trait Implementations

impl Clone for RemoteApiClient

fn clone(&self) -> RemoteApiClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.