Crate dnspod_lib

source ·
Expand description

DNSPod

该库使用 腾讯云 DNSPod API 3.0 版本, 不兼容旧版 API

DNSPod 简介

如果你在找 dnspod 的命令行工具, 请到 dnspod-cli

Examples

extern crate anyhow;
extern crate reqwest;
extern crate dnspod_lib;

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: "youran.de".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

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

自定义一个请求

extern crate dnspod_lib;

use dnspod_lib::prelude::*;
use dnspod_lib::define_action_list;
use dnspod_lib::serde;
use dnspod_lib::serde_json;

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

execute(DescribeDomain { Domain: "example.com".into() })?;

Re-exports

Modules

  • action
    定义各个 Action
  • consts
  • data_types
    参数类型 https://cloud.tencent.com/document/api/1427/78480
  • error_code
    错误码 https://cloud.tencent.com/document/api/1427/56192
  • header_params
    https://cloud.tencent.com/document/api/1427/56188
  • prelude
  • response
    返回结果 https://cloud.tencent.com/document/api/1427/56191 参数类型 https://cloud.tencent.com/document/api/1427/78480
  • signature
    签名方法 v3 https://cloud.tencent.com/document/api/1427/56189

Macros

Traits