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