API 文档
文档目录
    加载中
文档中心 API 文档 查询自定义线路

查询自定义线路

1. 接口描述

本接口 Custom.Line.List 用于对自定义线路进行查询操作。
接口请求地址:https://dnsapi.cn/Custom.Line.List
HTTP请求方式:POST

2. 请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。

参数名 是否必须 参数描述
domain_id 或 domain 分别对应域名ID和域名, 提交其中一个即可。

3. 响应代码

以下参数列表仅列出了此接口响应代码,除此接口请求响应代码外。还包含 共通返回

响应码 描述
7 当前域名无权限,请返回域名列表。
40601 参数错误。
40603 自定义线路名称不能为空。
40609 自定义线路IP段不能为空。
801 可用规格已用完,请升级解析套餐或购买增值服务。
802 可用规格已用完,请升级解析套餐或购买增值服务。
77 该线路正在使用当中,不能编辑。
40608 线路名称的长度不能超过17个字符。
40607 线路名称包含不被接受的字符。
400001 自定义线路正在被分组线路使用,无法修改,请暂停使用后重试。
40604 不是合法的IP段。
40606 IP已经存在。
81 该线路正在使用当中,不能删除。

4. 示例

查询自定义线路列表

curl -X POST https://dnsapi.cn/Custom.Line.List -d 'login_token=LOGIN_TOKEN&format=json&domain=dnspod.cn'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "操作已经成功完成",
        "created_at": "2021-11-25 11:49:01"
    },
    "data": {
        "areas": [
            {
                "domain_id": "1005",
                "name": "testline1",
                "area": "1.1.1.4-1.1.1.6",
                "use_count": 1,
                "max_count": 99999
            },
            {
                "domain_id": "1005",
                "name": "testline2",
                "area": "1.1.1.1-1.1.1.3",
                "use_count": 1,
                "max_count": 99999
            }
        ],
        "available_count": 5
    }
}

字段说明:

  • areas: 自定义线路列表
  • domain_id: 域名ID
  • name: 自定义线路名称
  • area: 自定义线路包含的IP段
  • available_count: 还可允许添加的自定义线路个数
最近更新于 2021-12-07 10:43

DNSPod 域名检测工具

查询域名信息,快速排查网站问题

网站自助排障

快速判断问题、提供合适的解决方案