文档 API参考

票证度量事件

您可以使用票证度量事件API来跟踪应答时间、代理工作时间和请求程序等待时间。

例如，如果您想要度量回复时间，那么您可以获得创建票证的时间和代理第一次回复票证的时间。如果您想要度量请求者等待时间，您可以获得创建票据的时间以及票据状态更改为已解决的时间。

《泰晤士报》报道称规事件或与以下三个指标相关的事件:应答时间、代理工作时间和请求程序等待时间。您可以访问以下六种类型的度量事件，根据度量，每种类型都有不同的事件:

  • 激活事件，例如在所有三个指标的情况下创建票据
  • 完成事件例如，在应答时间度量的情况下，当代理首次应答一个票据时，或者在请求者等待时间度量的情况下，当一个票据被解决时
  • 暂停事件，例如在座席工作时间度量的情况下，当票证状态更改为挂起或等待时
  • apply_sla事件例如，在票据上应用SLA策略时，或者在票据上更改SLA策略或目标时
  • 违约事件，例如SLA目标被破坏时
  • update_status事件，例如当实现度量时

每种类型的详细信息请参见票证度量事件类型引用．

JSON格式

票券度量事件表示为JSON对象，具有以下属性:

名字 类型 只读 强制性的 描述
id 整数 真正的 假 在创建记录时自动分配
即instance_id 整数 真正的 假 与事件关联的度量实例。看到即instance_id
度规 字符串 真正的 假 被跟踪的度量。取值为agent_work_time、pausable_update_time、periodic_update_time、reply_time、requester_wait_time、resolution_time。
ticket_id 整数 真正的 假 关联票的Id
时间 字符串 真正的 假 事件发生的时间
类型 字符串 真正的 假 度量事件的类型。看到票证度量事件类型引用．取值为activate、pause、fulfill、apply_sla、breach、update_status或measure。

除了上面的一般属性之外，根据事件的不同，可能还有其他属性可用类型：

名字 类型 只读 强制性的 评论
sla 对象 是的 没有 如果可用类型是“apply_sla”。SLA策略和目标在有问题的票证和度量标准上执行(如果有的话)。看到sla
状态 对象 是的 没有 如果可用类型是“update_status”。距离度量标准开放已经有几分钟了。看到状态
删除 布尔 是的 没有 如果可用类型是“违反”。通常，您可以忽略任何违约事件，当删除是真的。看到删除

即instance_id

使用即instance_id属性来跟踪每个票证可能发生多次的度量事件的每个实例，例如reply_time事件。该值在票证的生命周期内递增。

sla

可选的。的sla属性提供有关在相关票证和度量上实施的SLA策略和目标的关键信息。目标时间以分钟为单位，以及目标是否以业务小时或日历小时进行度量。还提供了策略信息，包括当前应用于票证的策略的ID、标题和描述。

状态

可选的。的状态属性提供该度量在业务和日历小时中已打开的分钟数。的状态属性只更新完成事件。任何尚未违反或至少完成一次的票务指标都不会有计算状态。

删除

可选的。的删除属性仅用于指示是否应忽略违约事件。通常，您可以忽略任何违约事件，其中删除是真的。

例子

             

              
{“id”：926256957613，“即instance_id”：1，“指标”：“agent_work_time”，“ticket_id”：155，“时间”：“2020 - 10 - 26 t12:53:12z”，“类型”：“测量”}

列出票证度量事件

  • GET / api / v2 /增量/ ticket_metric_events吗?start_time = {start_time}

返回在开始时间或之后发生的票证度量事件。

游标分页每页最多返回100条记录。事件按时间顺序列出。

如果没有对结果进行分页，则事件将作为基于时间的增量导出返回。

看到基于时间的增量出口．

分页

  • 光标分页
  • 没有分页

看到分页．

允许

  • 管理员

参数

名字 类型 在 要求 描述
start_time 整数 查询 真正的 您感兴趣的最早事件的Unix UTC纪元时间。例子:1332034771。

代码示例

旋度 
              

               
旋度https://{子域名}.亚博zendesk.com/api/v2/incremental/ticket_metric_events.json ? start_time＝1432155323＼- v - u{email_address}：{密码}
去 
              

               
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/incremental/ticket_metric_events?start_time=1332034771”方法：=“获得”要求的事情，犯错：=http．NewRequest（方法，url，零）如果犯错! =零{fmt．Println（犯错）返回}要求的事情．头．添加（“内容类型”，“application / json”）要求的事情．头．添加（“授权”，“基本< auth-value >”）// Base64编码的"username:password"客户端：=＆http．客户端{}res，犯错：=客户端．做（要求的事情）如果犯错! =零{fmt．Println（犯错）返回}推迟res．身体．关闭（）身体，犯错：=io．ReadAll（res．身体）如果犯错! =零{fmt．Println（犯错）返回}fmt．Println（字符串（身体））}
Java 
              

               
进口com．squareup．okhttp．*；OkHttpClient客户端＝新OkHttpClient（）；HttpUrl．构建器urlBuilder＝HttpUrl．解析（“https://example.亚博zendesk.com/api/v2/incremental/ticket_metric_events”）．newBuilder（）．addQueryParameter（“start_time”，“1332034771”）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs 
              

               
varaxios＝需要（“axios”）；var配置＝{方法：“得到”，url：“https://example.亚博zendesk.com/api/v2/incremental/ticket_metric_events”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，参数个数：{“start_time”：“1332034771”，}，}；axios（配置）．然后（函数（响应）{控制台．日志（JSON．stringify（响应．数据））；}）．抓（函数（错误）{控制台．日志（错误）；}）；
Python 
              

               
进口请求url＝“https://example.亚博zendesk.com/api/v2/incremental/ticket_metric_events?start_time=1332034771”头＝{“内容类型”：“application / json”，}响应＝请求．请求（“获得”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头）打印（响应．文本）
鲁比（人名） 
              

               
需要“net/http”uri＝URI（“https://example.亚博zendesk.com/api/v2/incremental/ticket_metric_events”）uri．查询＝URI．encode_www_form（“start_time”：“1332034771”）请求＝网：：HTTP：：得到．新（uri，“内容类型”：“application / json”）请求．basic_auth“用户名”，“密码”响应＝网：：HTTP．开始uri．主机名，uri．港口，use_ssl：真正的做|http|http．请求（请求）结束

示例响应(年代)

200好了 
              

               
//状态200 OK{“数”：3.，“end_time”：1603716792，“next_page”：“https://company.亚博zendesk.com/api/v2/incremental/ticket_metric_events.json?start_time=1603716792”，“ticket_metric_events”：［{“id”：926232157301，“即instance_id”：0，“指标”：“agent_work_time”，“ticket_id”：155，“时间”：“2020 - 10 - 26 t12:53:12z”，“类型”：“测量”}，{“id”：926232757371，“即instance_id”：1，“指标”：“agent_work_time”，“ticket_id”：155，“时间”：“2020 - 10 - 26 t12:53:12z”，“类型”：“激活”}，{“id”：926232927415，“即instance_id”：0，“指标”：“pausable_update_time”，“ticket_id”：155，“时间”：“2020 - 10 - 26 t12:53:12z”，“类型”：“测量”}］}