chml_api 0.8.0

Rust SDK for ChmlFrp
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use crate::domain::schema::{Domain, UserDomain};
use crate::{ChmlApi, res::ApiResult};

use crate::prelude::*;

/// list available domains
pub async fn get_available_domains(chml: &ChmlApi) -> ApiResult<Vec<Domain>> {
    let api_url = chml.endpoint("/list_available_domains");

    let req = chml.client.get(api_url).build()?;

    debug!("get available domains request: {:?}", req.url());

    let res = chml
        .client
        .execute(req)
        .await?
        .json::<ApiResponse<Vec<Domain>>>()
        .await?;
    debug!("get available domains response: {:?}", res);
    Ok(res)
}

/// get user free domains
pub async fn get_user_free_domains(chml: &ChmlApi) -> ApiResult<Vec<UserDomain>> {
    let api_url = chml.endpoint("/get_user_free_subdomains");

    let req = chml
        .client
        .get(api_url)
        .query(&[("token", chml.get_token()?)])
        .build()?;

    debug!("get user free domains request: {:?}", req.url());

    let res = chml
        .client
        .execute(req)
        .await?
        .json::<ApiResponse<Vec<UserDomain>>>()
        .await?;
    debug!("get user free domains response: {:?}", res);
    Ok(res)
}

#[derive(Debug, Serialize, Deserialize)]
pub struct CreateDomainParams {
    pub domain: String,
    pub record: String,
    pub r#type: String,
    pub ttl: String,
    pub target: String,
    pub remarks: Option<String>,
}

/// create free subdomain
pub async fn create_free_subdomain(chml: &ChmlApi, params: &CreateDomainParams) -> ApiResult<()> {
    let api_url = chml.endpoint("/create_free_subdomain");

    let req = chml
        .client
        .post(api_url)
        .header("Authorization", format!("Bearer {}", chml.get_token()?))
        .json(params)
        .build()?;

    debug!("create free subdomain request: {:?}", req.url());

    let res = chml
        .client
        .execute(req)
        .await?
        .json::<ApiResponse<()>>()
        .await?;
    debug!("create free subdomain response: {:?}", res);
    Ok(res)
}

/// delete free subdomain
pub async fn delete_free_subdomain(chml: &ChmlApi, domain: &str, record: &str) -> ApiResult<()> {
    let api_url = chml.endpoint("/delete_free_subdomain");

    let req = chml
        .client
        .post(api_url)
        .header("Authorization", format!("Bearer {}", chml.get_token()?))
        .json(&serde_json::json!({
            "domain": domain,
            "record": record
        }))
        .build()?;

    debug!("delete free subdomain request: {:?}", req.url());

    let res = chml
        .client
        .execute(req)
        .await?
        .json::<ApiResponse<()>>()
        .await?;
    debug!("delete free subdomain response: {:?}", res);
    Ok(res)
}

/// update free subdomain
pub async fn update_free_subdomain(chml: &ChmlApi, params: &CreateDomainParams) -> ApiResult<()> {
    let api_url = chml.endpoint("/update_free_subdomain");

    let req = chml
        .client
        .post(api_url)
        .header("Authorization", format!("Bearer {}", chml.get_token()?))
        .json(params)
        .build()?;

    debug!("update free subdomain request: {:?}", req.url());

    let res = chml
        .client
        .execute(req)
        .await?
        .json::<ApiResponse<()>>()
        .await?;
    debug!("update free subdomain response: {:?}", res);
    Ok(res)
}