文档 API参考

满意度评分

如果您为帐户启用了满意度评级，则此端点允许您快速检索所有评级。

在对结果进行分页时，它支持游标分页和偏移量分页。看到分页．

JSON格式

满意度评级表示为具有以下属性的JSON对象:

的名字 类型 只读 强制性的 描述
assignee_id 整数 真正的 真正的 评级时分配给代理的id
评论 字符串 假 假 如果可用的话，使用此评级收到的评论
created_at 字符串 真正的 假 满意度评分创建的时间
group_id 整数 真正的 真正的 在评级时分配给的组的id
id 整数 真正的 假 在创建时自动分配
原因 字符串 假 假 请求者在后续问题中给出差评的原因。满意的原因必须是启用
reason_code 整数 假 假 用户可以从列表菜单中选择给出负面评价的默认原因。看到原因代码在满意度原因API中。只能设置评分与分数“坏”。响应不包括此属性
reason_id 整数 假 假 Id，用户给出负面评价的原因。只能设置评分与分数“坏”。若要获取id的描述性值，请使用说明满意度评定的原因端点
requester_id 整数 真正的 真正的 提交评级的票据请求者的id
分数 字符串 假 真正的 “提供”，“非正式”，“好”或“坏”的评级
ticket_id 整数 真正的 真正的 被分级的船票id
updated_at 字符串 真正的 假 满意度评分更新的时间
url 字符串 真正的 假 这个等级的API url

例子

             

              
{“assignee_id”:135，“created_at”:“2011 - 07 - 20 - t22:55:29z”，“group_id”:44，“id”:35436，“requester_id”:7881，“分数”:“好”，“ticket_id”:208，“updated_at”:“2011 - 07 - 20 - t22:55:29z”，“url”:“https://company.亚博zendesk.com/api/v2/satisfaction_ratings/62.json”｝

清单满意度评分

  • GET / api / v2 / satisfaction_ratings

允许

  • 代理

过滤器

参数 价值
分数 Offered，非官方，received, received_with_comment, received_without_comment，
好的，good_with_comment, good_without_comment，
Bad, bad_with_comment, bad_without_comment
start_time 年龄最大的时间满意度评分，作为一个Unix纪元时间
end_time 最近满意度评分的时间，作为Unix纪元时间

如果指定了不合格的分数，例如好，结果包括所有有注释和没有注释的记录。

例子:

  • / api / v2 / satisfaction_ratings.json吗?分数=坏
  • / api / v2 / satisfaction_ratings.json吗?分数= bad&start_time = 1498151194
  • / api / v2 / satisfaction_ratings.json吗?start_time＝1340384793&end_time=1371920793

代码示例

旋度 
              

               
旋度https://{子域名｝.亚博zendesk.com/api/v2/satisfaction_ratings.json＼- v - u{email_address｝:{密码｝
去 
              

               
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/satisfaction_ratings”方法：=“获得”要求的事情，犯错：=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/satisfaction_ratings”）．newBuilder（）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs 
              

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

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

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

示例响应(年代)

200好了 
              

               
// Status 200 OK{“satisfaction_ratings”:［{“assignee_id”:135，“评论”:“了不起的支持!”，“created_at”:“2011 - 07 - 20 - t22:55:29z”，“group_id”:44，“id”:35436，“requester_id”:7881，“分数”:“好”，“ticket_id”:208，“updated_at”:“2011 - 07 - 20 - t22:55:29z”，“url”:“https://example.亚博zendesk.com/api/v2/satisfaction_ratings/35436.json”｝，{“assignee_id”:136，“评论”:“了不起的支持!”，“created_at”:“2012 - 02 - 01 - t04:31:29z”，“group_id”:44，“id”:120447，“requester_id”:7881，“分数”:“好”，“ticket_id”:209，“updated_at”:“2012 - 02 - 02 - t10:32:59z”，“url”:“https://example.亚博zendesk.com/api/v2/satisfaction_ratings/120447.json”｝]｝

计算满意度评分

  • GET / api / v2 / satisfaction_ratings /计数

返回帐户中满意度评级的大致计数。如果计数超过100,000，计数将返回一个缓存结果。这个缓存的结果将每24小时更新一次。

的数(refreshed_at)属性是一个时间戳，该时间戳指示上次更新计数的时间。

请注意:当计数超过100,000时，数(refreshed_at)可能偶尔为空。这表明计数正在后台更新，并且数(价值)在更新完成之前，限制为100,000。

允许

  • 代理

代码示例

旋度 
              

               
旋度https://{子域名｝.亚博zendesk.com/api/v2/satisfaction_ratings/count.json＼- v - u{email_address｝:{密码｝
去 
              

               
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/satisfaction_ratings/count”方法：=“获得”要求的事情，犯错：=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/satisfaction_ratings/count”）．newBuilder（）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs 
              

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

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

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

示例响应(年代)

200好了 
              

               
// Status 200 OK{“数”:{“refreshed_at”:“2020 - 04 - 06 - t02:18:17z”，“价值”:102｝｝

表演满意度评分

  • GET / api / v2 / satisfaction_ratings / {satisfaction_rating_id}

返回特定的满意度评级。您可以从清单满意度评分端点。

允许

  • 管理员

参数

的名字 类型 在 要求 描述
satisfaction_rating_id 整数 路径 真正的 要检索的满意度评级的id

代码示例

旋度 
              

               
旋度https://{子域名｝.亚博zendesk.com/api/v2/satisfaction_ratings/{satisfaction_rating_id｝. json＼- v - u{email_address｝:{密码｝
去 
              

               
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/satisfaction_ratings/35436”方法：=“获得”要求的事情，犯错：=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/satisfaction_ratings/35436”）．newBuilder（）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs 
              

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

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

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

示例响应(年代)

200好了 
              

               
// Status 200 OK{“satisfaction_rating”:［{“assignee_id”:135，“评论”:“了不起的支持!”，“created_at”:“2011 - 07 - 20 - t22:55:29z”，“group_id”:44，“id”:35436，“requester_id”:7881，“分数”:“好”，“ticket_id”:208，“updated_at”:“2011 - 07 - 20 - t22:55:29z”，“url”:“https://example.亚博zendesk.com/api/v2/satisfaction_ratings/35436.json”｝]｝

创建满意度评级

  • POST / api / v2 /票/ {ticket_id} / satisfaction_rating

为已解决的票据或先前已解决然后重新打开的票据创建CSAT评级。

只有被列为票据请求者的最终用户才能为票据创建满意度评级。

允许

  • 请求票据的最终用户

最终用户必须是已通过认证的用户。

参数

的名字 类型 在 要求 描述
ticket_id 整数 路径 真正的 机票的id

代码示例

旋度

良好的评级

              

               
旋度https://{子域名｝.亚博zendesk.com/api/v2/tickets/{ticket_id｝/ satisfaction_rating.json＼-X POST -d“{"satisfaction_rating": {"score": "good"， "comment": "Awesome support."}}’＼- v - u{email_address｝:{密码｝- h“application / json内容类型:
旋度

坏的评级

              

               
旋度https://{子域名｝.亚博zendesk.com/api/v2/tickets/{ticket_id｝/ satisfaction_rating.json＼-X POST -d“{"satisfaction_rating": {"score": "bad"， "comment": " need more detail."， "reason_code":100}}”＼- v - u{email_address｝:{密码｝- h“application / json内容类型:
去 
              

               
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/tickets/35436/satisfaction_rating”方法：=“职位”要求的事情，犯错：=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/tickets/35436/satisfaction_rating”）．newBuilder（）；RequestBody身体＝RequestBody．创建（MediaType．解析（“application / json”），”“＂”“＂）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“职位”，身体）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs 
              

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

               
进口请求url＝“https://example.亚博zendesk.com/api/v2/tickets/35436/satisfaction_rating”头＝{“内容类型”:“application / json”，｝响应＝请求．请求（“职位”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头）打印（响应．文本）
鲁比（人名） 
              

               
需要“net/http”uri＝URI（“https://example.亚博zendesk.com/api/v2/tickets/35436/satisfaction_rating”）请求＝网::HTTP::帖子．新（uri，“内容类型”:“application / json”）请求．basic_auth“用户名”，“密码”响应＝网::HTTP．开始uri．主机名，uri．港口，use_ssl:真正的做|http|http．请求（请求）结束

示例响应(年代)

200好了 
              

               
// Status 200 OK{“satisfaction_rating”:［{“assignee_id”:135，“评论”:“了不起的支持!”，“created_at”:“2011 - 07 - 20 - t22:55:29z”，“group_id”:44，“id”:35436，“requester_id”:7881，“分数”:“好”，“ticket_id”:208，“updated_at”:“2011 - 07 - 20 - t22:55:29z”，“url”:“https://example.亚博zendesk.com/api/v2/satisfaction_ratings/35436.json”｝]｝