功能簡介：
動態(tài)域名解析（Dynamic DNS，簡稱DDNS）可以讓用戶使用固定的域名來訪問動態(tài)IP地址，解決因IP地址變化造成服務(wù)無法訪問的情況。

本文將介紹如何使用西部數(shù)碼的API實(shí)現(xiàn)DDNS功能，使您的域名始終指向您的動態(tài)IP地址。

API介紹：

接口地址 https://api.west.cn/API/v2/domain/dns/     相關(guān)文檔...

接口支持兩種認(rèn)證方式

1、域名級認(rèn)證(僅單域名)

支持參數(shù) act=dnsrec.update&domain=指定域名&apidomainkey=域名密鑰&hostname=完整子域名&record_value=設(shè)置的IP
域名KEY獲取方法：

如下圖所示，進(jìn)入管理中心-域名管理-點(diǎn)擊域名-右側(cè)上方【ApiKey】 點(diǎn)擊后復(fù)制。

2、用戶級認(rèn)證 (支持管理多域名，僅限代理商使用)

支持參數(shù) act=dnsrec.update&username=用戶名&apikey=用戶密鑰&domain=指定域名&hostname=完整子域名&record_value=設(shè)置的IP

用戶KEY獲取地址：http://www.ps-sw.cn/manager/API/APIconfig.asp

注意：dnsrec.update接口在更新解析時會刪除存在的a記錄重新添加，其他api功能可參看 域名API接口文檔

使用示例：

• 群暉NAS

• openwrt - ddns-script

• DDNS-GO

1、群暉NAS - 內(nèi)置DDNS

配置示例 （不兼容IPv6，如需IPv6建議使用DDNS-GO的第三方套件或Docker實(shí)例）

首先添加自定義服務(wù)商

服務(wù)供應(yīng)商: 

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 服務(wù)商，密碼/密鑰請?zhí)顚懹蛎�的�?strong>ApiKey】，按截圖添加相應(yīng)的信息

2、openwrt - ddns-script組件

配置示例

這里的域名KEY填寫域名詳情頁的【ApiKey】，獲取方法見本文第一條。

注意：custom 模式下，您需要先在西部數(shù)碼的域名控制面板中手工添加一條 test.domain.com（其中test.domain.com要換為您自己的實(shí)際域名情況） 的A記錄解析。

3、DDNS-GO

配置示例 （兼容IPv6）

DNS服務(wù)商選擇【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：子域名:根域名  

注意在實(shí)際填寫時，將截圖中的：ddnsgo:westlytest.top 部分換為您自己的實(shí)際 情況，其中 ddnsgo 這部分是指子域名，可以定義為其他子域名，如bbs。

 westlytest.top 這個換為您自己的域名。