API 文档
文档目录
    加载中
文档中心 API 文档 按分类返回线路列表

按分类返回线路列表

1. 接口描述

本接口用于获取域名可选的线路列表,包含可用与不可用线路。
接口请求地址:https://dnsapi.cn/Record.Line.Category
HTTP请求方式:POST

2. 请求参数

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

参数名 是否必须 参数描述
domain_id 或 domain 分别对应域名ID和域名, 提交其中一个即可。
category_names 是否按分类获取,数组格式,不为空则仅返回包含的分组, 不传或传空则为全部分类。

3. 响应代码

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

响应码 描述
7 当前域名无权限,请返回域名列表。

4. 示例

按分类返回线路列表

curl -X POST https://dnsapi.cn/Record.Line.Category -d 'login_token=LOGIN_TOKEN&format=json&category_names=电信&domain_id=123'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "操作已经成功完成",
        "created_at": "2021-12-08 16:57:10"
    },
    "data": [
        {
            "line_name": "默认",
            "line_id": "0",
            "useful": true,
            "subgroup": []
        },
        {
            "line_name": "电信",
            "line_id": "10=0",
            "useful": true,
            "subgroup": [
                {
                    "line_name": "电信",
                    "line_id": "10=0",
                    "useful": true
                },
                {
                    "line_name": "安徽电信",
                    "line_id": "20=0",
                    "useful": false
                }
            ]
        },
        {
            "line_name": "自定义线路",
            "line_id": "",
            "useful": true,
            "subgroup": [
                {
                    "line_name": "testline1",
                    "line_id": "999=2",
                    "useful": true
                }
            ]
        }
    ]
}
最近更新于 2021-12-16 20:19

DNSPod 域名检测工具

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

网站自助排障

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