DNSPod
旗下子品牌
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 域名检测工具
查询域名信息,快速排查网站问题
网站自助排障
快速判断问题、提供合适的解决方案