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
• 无效的日期格式
• 工单创建日期不能是未来