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

1. 接口描述

本接口 Record.Ddns 用于更新动态 DNS 记录。
接口请求地址：https://dnsapi.cn/Record.Ddns
HTTP请求方式：POST

2. 请求参数

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

参数名称	是否必选	类型	描述
domain_id 或 domain	是	Integer 或 String	分别对应域名ID和域名, 提交其中一个即可。
record_id	是	Integer	记录ID。
sub_domain	否	String	主机记录，如 www。
record_line	是	String	记录线路，通过API记录线路获得，中文。比如：默认。
record_line_id	是	String	线路的ID，通过API记录线路获得，英文字符串，比如：‘10=1’。record_line 和 record_line_id 二者传其一即可，系统优先取 record_line_id。
value	否	String	IP 地址，支持 IPv4、IPv6，例如 1.2.3.4 或者 ff06::c3
ttl	否	Integer	TTL值，例如：600

3. 响应代码

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

响应码	描述
-15	域名已被封禁。
6	域名ID错误。
7	非域名所有者。
8	域名无效。
17	记录的值不正确。
21	域名被锁定。
22	子域名不合法。
23	子域名级数超出限制。
24	泛解析子域名错误。
500025	A记录负载均衡超出限制。
500026	CNAME记录负载均衡超出限制。
26	记录线路错误。

4. 示例

curl -X POST https://dnsapi.cn/Record.Ddns -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2317346&record_id=16894439&record_line_id=10%3D0&sub_domain=www'

返回示例如下：

JSON:

{
    "status": {
        "code":"1",
        "message":"Action completed successful",
        "created_at":"2015-01-18 17:23:58"
    },
    "record": {
        "id":16909160,
        "name":"@",
        "value":"111.111.111.111"
    }
}

字段说明:
id: 记录ID, 即为 record_id
name: 子域名
value: 记录值

注意：
record_line_id 形如 “10=3”，其中可能会包含等号，即 “=”，如果是通过类似 URL 传递参数，需要将 ‘=’ 转义成 ‘%3D’。

更新动态 DNS 记录

1. 接口描述

2. 请求参数

3. 响应代码

4. 示例

DNSPod 域名检测工具

网站自助排障