lyrics-search 0.3.1

Lyrics search functionality for various platforms
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! 网易云音乐 eapi 接口客户端，对应 C# `EapiHelper`。
//!
//! `params` 的构造（MD5 摘要与 AES-128-ECB 加密）由
//! [`lyrics_crypto::decrypter::netease::eapi`] 提供，本模块负责组装请求地址、请求头与
//! 请求正文。

use std::sync::LazyLock;

use rand::Rng;
use regex::Regex;
use serde_json::{Value, json};

use crate::error::SearchError;
use crate::providers::web::base_api;

/// eapi 专用 User-Agent，对应 C# `EapiHelper.userAgent`。
const USER_AGENT: &str = "Mozilla/5.0 (Linux; Android 9; PCT-AL10) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.64 HuaweiBrowser/10.0.3.311 Mobile Safari/537.36";

const REFERER: &str = "https://music.163.com/";

/// eapi 请求地址重写规则，对应 C# `Regex.Replace(url, @"\w*api", "eapi")`。
static EAPI_URL_RE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"\w*api").unwrap());

/// 以 eapi 协议向 `url` 发送 POST 请求，返回响应文本。
///
/// `data` 必须为 JSON 对象，函数会按 eapi 要求追加 `header` 字段；
/// 入参或内部构造的请求头不是 JSON 对象时返回 [`SearchError::Payload`]，
/// 请求或读取响应失败时返回对应的 [`SearchError`]。
pub(super) async fn post(url: &str, data: Value) -> Result<String, SearchError> {
    let Value::Object(mut data) = data else {
        return Err(SearchError::Payload(
            "eapi 请求参数必须是 JSON 对象".to_string(),
        ));
    };

    let header = request_header();
    let cookie = header
        .as_object()
        .ok_or_else(|| SearchError::Payload("eapi 请求头必须是 JSON 对象".to_string()))?
        .iter()
        .map(|(key, value)| format!("{key}={}", value.as_str().unwrap_or_default()))
        .collect::<Vec<_>>()
        .join("; ");
    data.insert(
        "header".to_string(),
        Value::String(serde_json::to_string(&header)?),
    );

    let params = lyrics_crypto::decrypter::netease::eapi::encrypt_params(
        url,
        &serde_json::to_string(&data)?,
    );

    let response = base_api::send_form(
        &EAPI_URL_RE.replace(url, "eapi"),
        &[("params", params.as_str())],
        &[
            ("User-Agent", USER_AGENT),
            ("Referer", REFERER),
            ("Cookie", cookie.as_str()),
        ],
    )
    .await?;

    base_api::text(response).await
}

/// 构造 eapi 请求的公共参数与同名 Cookie，对应 C# `EapiHelper.PostAsync` 中的 `header`。
fn request_header() -> Value {
    json!({
        "__csrf": "",
        "appver": "8.0.0",
        "buildver": base_api::unix_seconds().to_string(),
        "channel": "",
        "deviceId": "",
        "mobilename": "",
        "resolution": "1920x1080",
        "os": "android",
        "osver": "",
        "requestId": format!("{}_{:04}", base_api::unix_millis(), rand::rng().random_range(0..1000u32)),
        "versioncode": "140",
        "MUSIC_U": "",
    })
}