API 文档
文档目录
    加载中
文档中心 API 文档 获取等级允许的线路

获取等级允许的线路

注意:本页面提供 API 文档为 DNSPod 传统 API ,仅支持 DNSPod Token。仅限主账号调用,子账号不可用。 推荐使用 腾讯云 API 3.0 ,支持 CAM 权限管理,同时支持主账号、子账号调用。兼容腾讯云 API 密钥,提供 API Explorer、API 调用统计等工具,还可以与腾讯云其他产品更好协同使用。

1. 接口描述

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

2. 请求参数

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

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

域名等级, 分别为:

  • 旧套餐: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,解决之前部分开发者存在的中文编码问题。
最近更新于 2022-01-24 11:36

DNSPod 域名检测工具

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

网站自助排障

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