功能简介：
动态域名解析（Dynamic DNS，简称DDNS）可以让用户使用固定的域名来访问动态IP地址，解决因IP地址变化造成服务无法访问的情况。

本文将介绍如何使用的API实现DDNS功能，使您的域名始终指向您的动态IP地址。

API介绍：

接口地址 https://api.west.cn/API/v2/domain/dns/

接口支持两种认证方式

1、域名级认证(仅单域名)

支持参数 act=dnsrec.update&domain=指定域名&apidomainkey=域名密钥&hostname=完整子域名&record_value=设置的IP
域名KEY获取方法：

如下图所示，进入管理中心-域名管理-点击域名-右侧上方【ApiKey】点击后复制。

2、用户级认证 (支持管理多域名，仅限代理商使用)

支持参数 act=dnsrec.update&username=用户名&apikey=用户密钥&domain=指定域名&hostname=完整子域名&record_value=设置的IP

注意：dnsrec.update接口在更新解析时会删除存在的a记录重新添加，其他api功能可参看域名API接口文档

使用示例：

1、群晖NAS - 内置DDNS

配置示例（不兼容IPv6，如需IPv6建议使用DDNS-GO的第三方套件或Docker实例）

首先添加自定义服务商

服务供应商:

west
Query URL:

https://api.west.cn/API/v2/domain/dns/?act=dnsrec.update&domain=__USERNAME__&hostname=__HOSTNAME__&record_value=__MYIP__&apidomainkey=__PASSWORD__

新增DDNS，选择west 服务商，密码/密钥请填写域名的【ApiKey】，按截图添加相应的信息

2、openwrt - ddns-script组件

配置示例

参数名称 (英/中)	参数值	配置说明
Service provider/服务提供商	--custom--
update_url/自定义更新URL	https://api.west.cn/API/v2/domain/dns/?act=dnsrec.update&domain=[USERNAME]&hostname=[DOMAIN]&record_value=[IP]&apidomainkey=[PASSWORD]
LookupHost/查询主机名	test.domain.com	此项为要解析的主机名，如test.domain.com或者domain.com
domain/域名	test.domain.com	此项为要解析的主机名，如test.domain.com或者domain.com
username/用户名	domain.com	填写为主域名
password/密码	域名KEY	填写域名详情页的【ApiKey】

这里的域名KEY填写域名详情页的【ApiKey】，获取方法见本文第一条。

注意：custom 模式下，您需要先在的域名控制面板中手工添加一条 test.domain.com（其中test.domain.com要换为您自己的实际域名情况）的A记录解析。

3、DDNS-GO

配置示例（兼容IPv6）

DNS服务商选择【Callback】

URL：https://api.west.cn/API/v2/domain/dns/

RequestBody：act=dnsrec.update&domain=#{domain}&hostname=#{domain}&record_value=#{ip}&apidomainkey=域名KEY

注意这里的域名KEY填写域名详情页的【ApiKey】，获取方法见本文第一条。

Domains：子域名:根域名

的域名如何实现DDNS功能(动态解析)