PHP WHMCS UpdateClientDomain用法及代碼示例

更新客戶端域

請求參數

參數	類型	說明	必需的
action	string	“UpdateClientDomain”	Required
domainid	int	要更新的客戶端域的 ID。	Required
dnsmanagement	bool	是否啟用或禁用 DNS 管理。	Optional
emailforwarding	bool	是否啟用或禁用電子郵件轉發。	Optional
idprotection	bool	是否啟用或禁用 ID 保護。	Optional
donotrenew	bool	是否阻止續訂。	Optional
type	string	域名訂單的類型(“注冊”或“轉讓”)。	Optional
regdate	string	域的注冊日期。格式：Y-m-d	Optional
nextduedate	string	域的下一個到期日。格式：Y-m-d	Optional
expirydate	string	域的到期日期。格式：Y-m-d	Optional
domain	string	要更改的域名。	Optional
firstpaymentamount	float	域上的第一筆付款數量。	Optional
recurringamount	float	自動續訂發票的經常性數量。	Optional
registrar	string	與域關聯的注冊商。示例：enom、resellerclub、customregistrarname	Optional
regperiod	int	域名的注冊期限。	Optional
paymentmethod	string	以係統格式關聯的付款方式(例如，paypal)。	Optional
subscriptionid	string	要與域關聯的訂閱 ID。	Optional
status	string	要將域更改為的狀態。	Optional
notes	string	域的管理員注釋。	Optional
promoid	int	要關聯的促銷 ID。	Optional
autorecalc	bool	是否重新計算域的經常性數量(這將忽略任何傳遞的 $recurringamount)。	Optional
updatens	bool	是否在注冊商處更新名稱服務器。	Optional
ns1	string	第一個要保存的名稱服務器。	Optional
ns2	string	要保存的第二個名稱服務器。	Optional
ns3	string	要保存的第三個名稱服務器。	Optional
ns4	string	要保存的第四個名稱服務器。	Optional
ns5	string	要保存的第五個名稱服務器。	Optional

響應參數

參數	類型	說明
result	string	操作結果：成功或錯誤
domainid	int	更新域的 ID。

示例請求 (CURL)

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.example.com/includes/api.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,
    http_build_query(
        array(
            'action' => 'UpdateClientDomain',
            // See https://developers.whmcs.com/api/authentication
            'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
            'password' => 'SECRET_OR_HASHED_PASSWORD',
            'domainid' => '1',
            'status' => 'Terminated',
            'responsetype' => 'json',
        )
    )
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);

示例請求(本地 API)

$command = 'UpdateClientDomain';
$postData = array(
    'domainid' => '1',
    'status' => 'Terminated',
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later

$results = localAPI($command, $postData, $adminUsername);
print_r($results);

示例響應 JSON

{
    "result": "success",
    "domainid": "1"
}

錯誤響應

可能的錯誤條件響應包括：

• 未找到域 ID
• 注冊商未激活
• 需要 ns1 和 ns2
• 注冊商錯誤消息