PHP WHMCS UpdateContact用法及代碼示例

使用傳遞的參數更新聯係人。

請求參數

參數	類型	說明	必需的
action	string	“UpdateContact”	Required
contactid	int	要更新的聯係人的 id	Required
firstname	string		Optional
lastname	string		Optional
companyname	string		Optional
email	string		Optional
address1	string		Optional
address2	string		Optional
city	string		Optional
state	string		Optional
postcode	string		Optional
country	string	2 個字符的 ISO 國家代碼	Optional
phonenumber	string		Optional
email_preferences[general]	bool	客戶是否應該收到一般電子郵件	Optional
email_preferences[product]	bool	客戶是否應該收到產品電子郵件	Optional
email_preferences[domain]	bool	客戶是否應該收到域電子郵件	Optional
email_preferences[invoice]	bool	客戶是否應收到發票電子郵件	Optional
email_preferences[support]	bool	客戶是否應該收到支持電子郵件	Optional
email_preferences[affiliate]	bool	客戶是否應該收到附屬電子郵件	Optional

響應參數

參數	類型	說明
result	string	操作結果：成功或錯誤
contactid	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' => 'UpdateContact',
            // See https://developers.whmcs.com/api/authentication
            'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
            'password' => 'SECRET_OR_HASHED_PASSWORD',
            'contactid' => '1',
            'firstname' => 'John',
            'lastname' => 'Doe',
            'responsetype' => 'json',
        )
    )
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);

示例請求(本地 API)

$command = 'UpdateContact';
$postData = array(
    'contactid' => '1',
    'firstname' => 'John',
    'lastname' => 'Doe',
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later

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

示例響應 JSON

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

警告響應

使用已刪除或標記為已棄用的 API 函數時會返回警告響應。我們建議遵循警告中的任何建議操作，以確保未來的兼容性。

可能的警告消息包括：

• 不再支持子帳戶。請使用UpdateUser

錯誤響應

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

• 未找到聯係人 ID
• 重複的電子郵件地址
• 根據 ICANN 的要求，您必須至少啟用一個電子郵件地址才能接收域相關通知。要禁用域通知，請為主要帳戶持有人或其他聯係人啟用域通知