PHP WHMCS UpdateTicket用法及代碼示例

更新現有票證

請求參數

參數	類型	說明	必需的
action	string	“UpdateTicket”	Required
ticketid	int	要更新的工單 ID	Required
deptid	int	工單的部門id	Optional
status	string	票證狀態	Optional
subject	string	票的主題	Optional
userid	int	如果適用，更新票證的客戶 ID。	Optional
name	string	開票人的姓名(如果不是客戶)	Optional
email	string	開票人的電子郵件地址(如果不是客戶)	Optional
cc	string	工單的抄送電子郵件地址	Optional
priority	string	工單的優先級(“低”、“中”、“高”)	Optional
created	string	初始消息將顯示為已創建的日期和時間。格式：ISO8601 或YYYY-MM-DD HH:mm:ss	Optional
flag	int	將票標記到的管理員 ID	Optional
removeFlag	bool	從票證上移除標誌	Optional
message	string	更新票務信息	Optional
markdown	bool	是否應在工單輸出上使用降價。	Optional
customfields	string	Base64 編碼的自定義字段值序列化數組	Optional

響應參數

參數	類型	說明
result	string	操作結果：成功或錯誤
ticketid	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' => 'UpdateTicket',
            // See https://developers.whmcs.com/api/authentication
            'username' => 'IDENTIFIER_OR_ADMIN_USERNAME',
            'password' => 'SECRET_OR_HASHED_PASSWORD',
            'ticketid' => '1',
            'subject' => 'This is a sample updated ticket subject',
            'clientid' => '1',
            'responsetype' => 'json',
        )
    )
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
curl_close($ch);

示例請求(本地 API)

$command = 'UpdateTicket';
$postData = array(
    'ticketid' => '1',
    'subject' => 'This is a sample updated ticket subject',
    'clientid' => '1',
);
$adminUsername = 'ADMIN_USERNAME'; // Optional for WHMCS 7.2 and later

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

示例響應 JSON

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

錯誤響應

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

• 未找到票證 ID
• 未找到部門 ID
• 無效的票證優先級。有效的優先級是：低、中、高
• 無效的票證狀態。有效狀態為：xxx
• 無效的日期格式
• 工單創建日期不能是未來