# DNSPod 

该库使用 [腾讯云 DNSPod API 3.0](https://docs.dnspod.cn/api/api3/) 版本, 不兼容旧版 API  

[DNSPod 简介](https://cloud.tencent.com/document/api/1427/56193)  


如果你在找 dnspod 的命令行工具, 请到 [dnspod-cli](https://crates.io/crates/dnspod-cli)

# Examples

```rust
extern crate anyhow;
extern crate reqwest;

use anyhow::Result;

use dnspod_lib::serde_json;
use dnspod_lib::prelude::*;
use dnspod_lib::data_types::DomainType;

fn main() -> Result<()> {
    let res = execute(
        DescribeDomainList {
            Type: DomainType::ALL,
            Offset: 0,
            Limit: 0,
            GroupId: 0,
            Keyword: None,
        }
    ); // ?;
    println!("res: {:?}", res);

    let res = execute(
        DescribeRecordList {
            Domain: "example.com".into(),
            Subdomain: None,
            Keyword: None,
        }
    ); // ?;
    println!("res: {:?}", res);

    Ok(())
}

fn execute(request: impl ExtractCommonParams) -> Result<serde_json::Value> {
    let client = reqwest::blocking::Client::new();

    let secret_id = std::env::var("DNSPOD_SECRET_ID")?;
    let secret_key = std::env::var("DNSPOD_SECRET_KEY")?;

    let url = request.url();
    let body = request.body();
    let headers = request.headers(&secret_id, &secret_key);
    let headers = (&headers).try_into()?;

    let request = client
        .post(url)
        .headers(headers)
        .body(body)
        .build()?;

    // let res: Response = client
    let res: serde_json::Value = client
        .execute(request)?
        .json()?;

    Ok(res)
}
```

## Run

```console
 DNSPOD_SECRET_ID=your-secret-id DNSPOD_SECRET_KEY=your-secret-key cargo run
```

# 自定义一个请求

```rust
// 自定义代码中没有实现的请求
dnspod_lib::define_action_list! {
    /// 获取域名信息
    /// https://cloud.tencent.com/document/api/1427/56173
    @[url = "https://example.com"] // 公共参数可以重载 url, version, region
    pub struct DescribeDomain {
        /// 域名分组类型，默认为ALL
        #[serde(rename = "Domain")]
        pub domain: String,
    }

    @[version = dnspod_lib::data_types::Version::Version2021_03_23]
    #[allow(non_snake_case)]
    pub struct CustomAction {
        /// 域名分组类型，默认为ALL
        pub Domain: String,
        // ...
    }
}

// execute(DescribeDomain { domain: "example.com".into() })?;
```