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

查询自定义线路分组

1. 接口描述

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

2. 请求参数

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

参数名 是否必须 参数描述
domain_id 或 domain 分别对应域名ID和域名, 提交其中一个即可。
offset 偏移量,默认值为0。
length 限制数量。
sort_type 按自定义线路分组名称排序的方向。升序传asc,降序传desc。

3. 响应代码

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

响应码 描述
7 当前域名无权限,请返回域名列表。
400011 可用规格已用完,请升级解析套餐或购买增值服务。
400002 分组名为空。
400014 分组名为1-17个字符。
400003 指定的分组名已存在,或为系统内置线路或自定义线路,无法用于分组名称。
400004 线路格式不正确。
400005 线路不存在,或者线路不支持自定义分组。
400018 默认线路无法进行自定义线路分组。
400017 线路已存在于其他分组中。
400006 您至少需要选择一个线路。
400015 最多只能选择120个线路。
400007 分组不存在,请确认是否已经被删除了。
400019 分组不属于当前域名,请确认您是否有权限修改分组。
400013 线路正在使用当中,无法修改名称。
8 不允许操作生效中或失效中的域名。
500000 线路分组更新失败,原因:内部错误。
400021 线路正在使用当中,无法删除名称。
400008 源域名ID格式不正确。
400009 您不是源域名所有者,无法复制线路。
400020 域名自己无需进行复制。
400016 当前域名等级低于源域名的等级,无法进行复制。
400010 您复制的线路已存在,无需重复复制。
400001 不支持的操作类型。

4. 示例

查询自定义线路分组列表

curl -X POST https://dnsapi.cn/Custom.Line.Group.List -d 'login_token=LOGIN_TOKEN&format=json&domain=dnspod.cn&offset=0&length=20&sort_type=desc'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "操作已经成功完成",
        "created_at": "2021-11-23 18:00:12"
    },
    "data": {
        "line_groups": [
            {
                "id": "9",
                "domain_id": "1005",
                "name": "group06",
                "lines": [
                    "必应"
                ],
                "created_on": "2021-11-18 16:45:15",
                "updated_on": "2021-11-19 10:55:13"
            }
        ],
        "info": {
            "now_total": 3,
            "total": 5,
            "available_count": 5
        }
    }
}

字段说明:

  • line_groups: 自定义线路分组列表
  • id: 自定义线路分组ID
  • domain_id: 域名ID
  • name: 自定义线路分组名称
  • lines: 自定义线路分组包含的线路列表
  • created_on: 添加时间
  • updated_on: 修改时间
  • info: 自定线路分组数量
  • now_total: 本次请求返回自定义线路分组个数
  • total: 自定义线路分组总数
  • available_count: 还可允许添加的自定义线路分组个数
最近更新于 2021-12-07 10:37

DNSPod 域名检测工具

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

网站自助排障

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