名字	类型	只读	强制性的	描述
标签	数组	假	真正的	字符串数组

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

Nodejs

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

Python

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

鲁比（人名）

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

示例响应(年代)

200好了

              
               //状态200 OK{“数”：1，“next_page”：零，“previous_page”：零，“标签”：［{“数”：10，“名称”：“分类”}]}

搜索标签

GET / api / v2 /自动完成/标记

属性中指定的字符开头的已注册和最近使用的标记名数组名字查询参数。必须指定至少2个字符。

分页

仅偏移分页

看到使用偏移分页。

允许

代理

参数

名字	类型	在	要求	描述
tag_name_fragment	字符串	查询	假	要搜索的标记的子字符串

代码示例

旋度

              
               旋度https://{子域名}.亚博zendesk.com/api/v2/autocomplete/tags.json ?名字=丙氨酸＼- u{email_address}：{密码}

去

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

Nodejs

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

Python

              
               进口请求url=“https://example.亚博zendesk.com/api/v2/autocomplete/tags?tag_name_fragment=att”头={“内容类型”：“application / json”，}响应=请求。请求（“获得”，url，身份验证=（“<用户名>”，' <密码> '），头=头）打印（响应。文本）

鲁比（人名）

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

示例响应(年代)

200好了

              
               //状态200 OK{“标签”：［“关注”，“攻击”]}

数的标签

GET / api / v2 /标签/计数

返回标记的大致计数。如果超过100,000，则每24小时更新一次。

的refreshed_at的性质数对象是一个时间戳，它指示计数最后更新的时间。

请注意:当计数超过100,000时，refreshed_at的财产数对象有时可能为空。这表明计数正在后台更新价值的财产数对象被限制为100,000，直到更新完成。

允许

管理员

代码示例

旋度

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

去

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

Nodejs

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

Python

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

鲁比（人名）

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

示例响应(年代)

200好了

              
               //状态200 OK{“数”：{“refreshed_at”：“2020 - 04 - 06 - t02:18:17z”，“价值”：102}}

列出资源标签

拿到票/ api / v2 / / {ticket_id} /标记
GET / api / v2 /组织/ {organization_id} /标记
GET / api / v2 /用户/ {user_id} /标记

允许

代理

参数

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

代码示例

旋度

              
               旋度https://{子域名}.亚博zendesk.com/api/v2/tickets/{ticket_id}/ tags.json＼- v - u{email_address}：{密码}

去

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

Nodejs

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

Python

              
               进口请求url=“https://example.亚博zendesk.com/api/v2/tickets/123456/tags”头={“内容类型”：“application / json”，}响应=请求。请求（“获得”，url，身份验证=（“<用户名>”，' <密码> '），头=头）打印（响应。文本）

鲁比（人名）

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

示例响应(年代)

200好了

              
               //状态200 OK{“标签”：［“紧急”，“打印机”，“火”]}

添加标签

把/ api / v2 /票/ {ticket_id} /标记
把/ api / v2 /组织/ {organization_id} /标记
把/ api / v2 /用户/ {user_id} /标记

也可以为多个票添加标签更新多张票端点。

安全更新

如果同一个票证被多个API请求同时更新，一些标签可能会因为票证更新冲突而丢失。包括updated_stamp和safe_update属性以进行安全更新。

为updated_stamp，检索并指定票证的最新日期updated_at时间戳。标记更新仅在updated_stamp时间戳与票据的实际相符updated_at请求时的时间戳。如果时间戳不匹配(换句话说，如果自上次检索票据以来更新了票据updated_at时间戳)，请求返回一个409冲突错误。

例子

             
              {“标签”：［“客户”]，“updated_stamp”：“2019 - 09 - 12 - t21:45:16z”，“safe_update”：“真正的”}

有关详情，请参阅防止票证更新冲突。

允许

代理

参数

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

代码示例

旋度

              
               旋度https://{子域名}.亚博zendesk.com/api/v2/tickets/{ticket_id}/ tags.json＼-X PUT -d'{"tags": ["customer"]}'＼- h“application / json内容类型:＼- v - u{email_address}：{密码}

去

              
               进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/tickets/123456/tags”方法：=“把”要求的事情，犯错：=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/123456/tags”）。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/123456/tags”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，}；axios（配置）。然后（函数（响应）{控制台。日志（JSON。stringify（响应。数据））；}）。抓（函数（错误）{控制台。日志（错误）；}）；

Python

              
               进口请求url=“https://example.亚博zendesk.com/api/v2/tickets/123456/tags”头={“内容类型”：“application / json”，}响应=请求。请求（“把”，url，身份验证=（“<用户名>”，' <密码> '），头=头）打印（响应。文本）

鲁比（人名）

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

示例响应(年代)

200好了

              
               //状态200 OK{“标签”：［“紧急”，“打印机”，“火”]}

设置标签

POST / api / v2 /票/ {ticket_id} /标记
POST / api / v2 /组织/ {organization_id} /标记
POST / api / v2 /用户/ {user_id} /标记

允许

代理

参数

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

代码示例

旋度

              
               旋度https://{子域名}.亚博zendesk.com/api/v2/tickets/{ticket_id}/ tags.json＼-X POST -d'{"tags": ["important"]}'＼- h“application / json内容类型:＼- v - u{email_address}：{密码}

去

              
               进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://example.亚博zendesk.com/api/v2/tickets/123456/tags”方法：=“职位”要求的事情，犯错：=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/123456/tags”）。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/123456/tags”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，}；axios（配置）。然后（函数（响应）{控制台。日志（JSON。stringify（响应。数据））；}）。抓（函数（错误）{控制台。日志（错误）；}）；

Python

              
               进口请求url=“https://example.亚博zendesk.com/api/v2/tickets/123456/tags”头={“内容类型”：“application / json”，}响应=请求。请求（“职位”，url，身份验证=（“<用户名>”，' <密码> '），头=头）打印（响应。文本）

鲁比（人名）

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

示例响应(年代)

201年创建

              
               //状态201创建{“标签”：［“紧急”，“打印机”，“火”]}

删除标签

删除/ api / v2 /票/ {ticket_id} /标记
删除/ api / v2 /组织/ {organization_id} /标记
删除/ api / v2 /用户/ {user_id} /标记

也可以从多个票据中删除标签更新多张票端点。

此端点支持安全更新。看到安全更新。

允许

代理

参数

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

代码示例

旋度

              
               旋度https://{子域名}.亚博zendesk.com/api/v2/tickets/{ticket_id}/ tags.json＼-X DELETE -d'{"tags": ["customer"]}'＼- h“application / json内容类型:- v - u{email_address}：{密码}

去

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

Nodejs

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

Python

              
               进口请求url=“https://example.亚博zendesk.com/api/v2/tickets/123456/tags”头={“内容类型”：“application / json”，}响应=请求。请求（“删除”，url，身份验证=（“<用户名>”，' <密码> '），头=头）打印（响应。文本）

鲁比（人名）

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

示例响应(年代)

204无内容

              
               //状态204无内容零

标签

JSON格式

列表标签

分页

允许

代码示例

示例响应(年代)

搜索标签

分页

允许

参数

代码示例

示例响应(年代)

数的标签

允许

代码示例

示例响应(年代)

列出资源标签

允许

参数

代码示例

示例响应(年代)

添加标签

安全更新

例子

允许

参数

代码示例

示例响应(年代)

设置标签

允许

参数

代码示例

示例响应(年代)

删除标签

允许

参数

代码示例

示例响应(年代)