MyName 網域註冊服務

WebNIC API v2 文件 - 第二部分

網域轉移、續約、資訊、管理功能等詳細技術文件。

返回第一部分 API 文件首頁
網域轉移 網域續約 網域資訊 管理功能

目錄

網域操作

管理功能

參考資料

開發者資源

網域轉移

將網域從其他註冊商轉移到 WebNIC。

POST /domain/v2/transfer
轉移網域

請求參數

參數 類型 說明 必填
domainName string 網域名稱（例如：example.com） 必填
authCode string 授權碼（從原註冊商取得） 必填
registrantContactId string 註冊人聯絡人 ID 必填
adminContactId string 管理聯絡人 ID 必填
techContactId string 技術聯絡人 ID 必填
billingContactId string 帳務聯絡人 ID 必填
nameservers array 名稱伺服器陣列（最多 13 個） 必填

請求範例

JSON 
{
  "domainName": "example.com",
  "nameservers": ["ns1.newnameserver.com", "ns2.newnameserver.com"]
}

回應範例

JSON 
{
  "code": 0,
  "data": {
    "domainName": "example.com",
    "updated": true
  }
}

注意： 名稱伺服器變更需要 24-48 小時才能在全球 DNS 系統中生效。

帳戶餘額

查詢帳戶的當前餘額。

GET /reseller/v2/account/balance
查詢帳戶餘額

請求範例

HTTP 
GET https://api.webnic.cc/reseller/v2/account/balance
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json
Accept: application/json

回應範例

JSON 
{
  "code": 0,
  "data": {
    "balance": 1000.50,
    "currency": "USD",
    "creditLimit": 5000.00,
    "availableCredit": 4000.50
  }
}

提示： 建議在進行網域註冊或轉移操作前先檢查帳戶餘額，確保有足夠資金。

錯誤代碼

WebNIC API v2 使用標準化的錯誤代碼系統。

錯誤代碼 說明 建議操作
0 成功 操作成功完成
1001 認證失敗 檢查 API 使用者名稱和密鑰
1002 Token 過期 重新取得 Token
2001 網域不可用 網域已被註冊或保留
2002 網域格式錯誤 檢查網域名稱格式
3001 餘額不足 充值帳戶餘額
3002 價格錯誤 檢查網域價格
4001 聯絡人資訊錯誤 檢查聯絡人資料格式
4002 聯絡人驗證失敗 聯絡人資訊需要驗證
5001 系統錯誤 稍後重試或聯繫支援
5002 服務暫時不可用 稍後重試

注意： 所有錯誤回應都包含 code 和 message 欄位，用於診斷問題。

更新歷史

WebNIC API v2 的重要更新記錄。

2025-11-11

網域續約功能更新

  • 新增 domainExpiryDate 參數到網域續約端點
  • 改善續約驗證邏輯
  • 新增續約確認郵件通知

2025-11-03

新增主機端點

  • 新增主機（Host）管理功能
  • 支援主機記錄的建立、查詢和刪除
  • 改善 DNS 管理功能

2025-07-28

WHOIS 協議更新

  • 更新 WHOIS 資料處理協議
  • 改善聯絡人驗證流程
  • 新增支援更多頂級域名（TLD）

2025-06-27

參數名稱修正

  • 修正 whoisPrivacy 參數名稱（原為 whoisprivacy）
  • 統一參數命名規範
  • 改善錯誤訊息可讀性

提示： 建議定期檢查 API 更新歷史，確保您的整合保持最新狀態。

速率限制

WebNIC API v2 實施速率限制以確保服務穩定性。

標準限制

大多數端點

  • 每分鐘 60 次請求
  • 每小時 1000 次請求
  • 每天 10000 次請求

認證限制

Token 相關端點

  • 每分鐘 10 次請求
  • 每小時 100 次請求
  • 每天 500 次請求

重要： 超過速率限制會收到 HTTP 429 錯誤，建議實作請求佇列和重試機制。

提示： 快取常用資料（如網域查詢結果）可以減少 API 請求次數。

>array 名稱伺服器陣列 選填 whoisPrivacy boolean 是否啟用 WHOIS 隱私保護 選填

請求範例

JSON 
{
  "domainName": "example.com",
  "authCode": "ABC123DEF456",
  "registrantContactId": "C12345678",
  "adminContactId": "C12345678",
  "techContactId": "C12345678",
  "billingContactId": "C12345678",
  "nameservers": ["ns1.example.com", "ns2.example.com"],
  "whoisPrivacy": true
}

回應範例

JSON 
{
  "code": 0,
  "data": {
    "domainName": "example.com",
    "orderId": "TRF12345678",
    "status": "pending",
    "price": 12.00,
    "currency": "USD"
  }
}

注意： 網域轉移通常需要 5-7 天完成，期間網域服務不會中斷。

重要： 轉移網域前請確保網域已解鎖且授權碼正確，否則轉移會失敗。

網域續約

續約已註冊的網域。

POST /domain/v2/renew
續約網域

請求參數

參數 類型 說明 必填
domainName string 網域名稱（例如：example.com） 必填
period integer 續約年限（1-10年） 必填
domainExpiryDate string 網域到期日期（YYYY-MM-DD） 必填

請求範例

JSON 
{
  "domainName": "example.com",
  "period": 1,
  "domainExpiryDate": "2026-03-25"
}

回應範例

JSON 
{
  "code": 0,
  "data": {
    "domainName": "example.com",
    "orderId": "REN12345678",
    "newExpiryDate": "2027-03-25T00:00:00Z",
    "price": 12.00,
    "currency": "USD"
  }
}

注意： 網域續約建議在到期前 30 天內進行，避免網域過期。

重要： 網域過期後有 30 天寬限期，寬限期後網域將被刪除。

網域資訊

查詢網域的詳細資訊。

GET /domain/v2/info
查詢網域資訊

請求參數

參數 類型 說明 必填
domainName string 網域名稱（例如：example.com） 必填

請求範例

HTTP 
GET https://api.webnic.cc/domain/v2/info?domainName=example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json
Accept: application/json

回應範例

JSON 
{
  "code": 0,
  "data": {
    "domainName": "example.com",
    "status": "active",
    "creationDate": "2025-03-25T00:00:00Z",
    "expiryDate": "2026-03-25T00:00:00Z",
    "registrantContactId": "C12345678",
    "adminContactId": "C12345678",
    "techContactId": "C12345678",
    "billingContactId": "C12345678",
    "nameservers": ["ns1.example.com", "ns2.example.com"],
    "whoisPrivacy": true,
    "autoRenew": true
  }
}

提示： 使用此端點可以檢查網域的當前狀態、聯絡人資訊和設定。

修改聯絡人

更新網域的聯絡人資訊。

PUT /domain/v2/contact
更新聯絡人

請求參數

參數 類型 說明 必填
contactId string 聯絡人 ID 必填
name string 聯絡人姓名 選填
email string 電子郵件地址 選填
organization string 組織/公司名稱 選填
address1 string 地址第一行 選填
city string 城市 選填
state string 州/省 選填
country string 國家代碼 選填
zipCode string 郵遞區號 選填
phone string 電話號碼 選填

請求範例

JSON 
{
  "contactId": "C12345678",
  "email": "newemail@example.com",
  "phone": "+886.987654321"
}

回應範例

JSON 
{
  "code": 0,
  "data": {
    "contactId": "C12345678",
    "updated": true
  }
}

注意： 修改聯絡人資訊可能需要驗證，某些頂級域名（TLD）有特殊要求。

修改名稱伺服器

更新網域的名稱伺服器（DNS）設定。

PUT /domain/v2/nameservers
更新名稱伺服器

請求參數

參數 類型 說明 必填
domainName string 網域名稱 必填
nameservers