網域 API 版本資訊

以下是Domains API的發行說明。我們會確保您了解所有即將推出的功能版本及新功能。

2020年4月

WHOIS隱私權變更
現已推出：.APP，.DEV及.PAGE
不確定商標聲明TLD
DNS區域記錄限制
DNS區域記錄頁面大小

WHOIS隱私權變更

從2020年7月1日起，我們將會改善隱私保護功能，讓您可以更有效地管理網域的隱私保護方式。首先，您可以啟用或停用隱私權，而不必取消並重新購買產品。當您首次在網域中新增隱私權後，我們會使用Proxy聯絡資訊取代您的個人聯絡資訊，以便回應WHOIS的詢問。為了在WHOIS中暫時公開您的個人聯絡資訊，我們新引入了一個WOW實體，以及用來驗證是否同意公開個人聯絡資料的新協議金鑰：

PATCH /v1/domains/mydomain.com“ consent”：{“ agreedAt”：“ 2020-03-30T10：00：00Z”，“ agreedby”：“ 12.13.14.15”，“ agreementKeys”：[“ EXPOSE_WHOIS”]} ，“ exposeWhois”：“ true”

Proxy的聯絡資訊可以使用下列命令進行還原，無需達成協議金鑰：

修補程式/v1/domains/mydomain.com“ exposeWhois”：“ false”

此外，從2020年7月1日起，我們會提供免費的基礎版隱私保護，適用於所有新網域以及尚未使用我們進階隱私保護的現有網域。基礎版隱私權會遮罩WHOIS查詢中的大部分個人聯絡資料，只會顯示公司名稱，國家/地區與州別。若是網域設有基本隱私保護，可以使用與上述相同的API指令在WHOIS中公開或遮罩個人聯絡資訊。

現已推出：.APP，.DEV及.PAGE

自2020年4月28日起，API使用者可註冊.APP，.DEV及.PAGE網域，並提供特殊的住宿條件。 .APP，.DEV和.PAGE被指定為安全的名稱空間。所有主要的瀏覽器都要求這些名稱空間中的網域必須有SSL憑證。

註冊人不須購買SSL憑證即成為購買網域的先決條件，但網域名稱提供商必須在註冊時通知註冊人，他們需要使用SSL憑證才能在瀏覽器中服務網域。。

您可以透過下列API方法取得此規範的完整詳細資訊：

GET / v1 / domains / agreements？tlds = APP

為了支援這些特殊TLD，我們在購買端點內文的同意區段中加入了稱為HTTPS_NOTICE的額外協定金鑰，供用戶確認他們已檢視此需求並希望繼續進行註冊。包含此新的必要協議金鑰，有效的購買要求中的同意區段將如下所示：

POST / v1 / domains / purchase“ domain”：“ mydomain.app”，“ consent”：{“ agreedAt”：“ 2020-03-30T10：00：00Z”，“ agreedby”：“ 12.13.14.15”，“ agreementKeys” “ :: [” DNRA“，” HTTPS_NOTICE“]}，...

不確定商標聲明TLD

API新增了13個TLD：ACCOUNTANT，.CRICKET，.DATE，.DOWNLOAD，.FAITH，.LOAN，.MEN，.PARTY，.RACING，.REVIEW，.SCIENCE，.STORAGE及.WIN。這些TLD的商標申請期限不確定。目前，這13個名稱空間中有商標聲明的網域將被視為無法使用。無商標聲明的網域可以正常購買。

DNS區域記錄限制

為確保我們的DNS管理功能可擴展至所有用戶端，我們正在限制可在單一區域內建立的記錄數。從2020年4月28日起，標準DNS客戶每個區域最多可建立500筆紀錄，超豪版DNS客戶每個區域最多可建立1,500筆紀錄。此變更將影響以下終結點：

PUT / v1 / domains / {domain} / records PUT / v1 / domains / {domain} / records / {type} PUT / v1 / domains / {domain} / records / {type} / {name} PATCH / v1 / domains / {domain} / records

調用以上任一終結點時，我們會評估要求的區域更新是否會導致區域超過紀錄限制。如果沒有，我們會正常處理要求。如果是這樣，我們會傳回422的回應，並附上以下錯誤詳細資訊：

訊息：ZONE_LIMIT_EXCEEDED訊息：區域不可超過500筆紀錄；要求的操作會超出限制。

對於目前超過限制的區域，所有現有記錄將保持不變。但是，在區域記錄總數不會超過記錄限制之前，不得新增任何記錄，可以使用PUT方法完成。

DNS區域記錄頁面大小

從區域擷取記錄時，限制參數用來表示要擷取的記錄數。為確保系統可擴充性，我們將於2020年4月28日起實施500筆記錄的上限。此變更將影響以下終結點：

GET / v1 / domains / {domain} / records GET / v1 / domains / {domain} / records / {type}

收到限制大於500的要求時，我們會傳回422回應，並附有以下錯誤詳細資訊：

程式碼：VALUE_OVER訊息：限制數值不得超過500。

使用者依然可以使用「offset」（限制）及「limit」（限制）參數，以最大500個頁面的規模，檢視所有區域記錄。

API 經銷商 說明