API 文档
文档目录
服务与支持 API 文档 获取等级允许的线路
获取等级允许的线路

1. 接口描述

本接口 Record.Line 获取等级允许的线路。
接口请求地址:https://dnsapi.cn/Record.Line
HTTP请求方式:POST

2. 请求参数

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

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

域名等级, 分别为:

  • 旧套餐:D_Free、D_Plus、D_Extra、D_Expert、D_Ultra 分别对应免费套餐、个人豪华、企业1、企业2、企业3。
  • 新套餐:DP_Free、DP_Plus、DP_Extra、DP_Expert、DP_Ultra 分别对应新免费、个人专业版、企业创业版、企业标准版、企业旗舰版。

3. 响应代码

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

响应码 描述
6 域名ID错误、域名等级错误。
7 非域名所有者。
8 域名无效。
13 当前域名有误,请返回重新操作。

4. 示例

curl -X POST https://dnsapi.cn/Record.Line -d 'login_token=LOGIN_TOKEN&format=json&domain_grade=D_Free&domain_id=2059079'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "Action completed successful",
        "created_at": "2016-08-12 17:08:56"
    },
    "line_ids": {
        "默认": 0,
        "国内": "7=0",
        "国外": "3=0",
        "电信": "10=0",
        "联通": "10=1",
        "教育网": "10=2",
        "移动": "10=3",
        "百度": "90=0",
        "谷歌": "90=1",
        "搜搜": "90=4",
        "有道": "90=2",
        "必应": "90=3",
        "搜狗": "90=5",
        "奇虎": "90=6",
        "搜索引擎": "80=0"
    },
    "lines": [
        "默认",
        "国内",
        "国外",
        "电信",
        "联通",
        "教育网",
        "移动",
        "百度",
        "谷歌",
        "搜搜",
        "有道",
        "必应",
        "搜狗",
        "奇虎",
        "搜索引擎"
    ]
}

说明:

  • 如果域名等级没有变更,则每次返回的允许的线路都是一致的,建议获取成功后在本地保存一份, 不要用一次就请求一次。
  • line_ids 为新增的返回字段,对应关系为: 中文线路名称:线路ID,支持在创建、修改解析记录的时候传入线路ID,解决之前部分开发者存在的中文编码问题。
最近更新于 2020-09-08 10:26