链接
链接是Jira问题和Zendesk票证之间的连接。亚博您可以使用这个API列出、创建和删除链接。
JSON格式
链接被表示为具有以下属性的JSON对象:
| 名字 | 类型 | 只读 | 强制性的 | 描述 |
|---|---|---|---|---|
| created_at | 字符串 | 真正的 | 假 | 创建链接的时间 |
| id | 整数 | 真正的 | 假 | 在创建链路时自动分配 |
| issue_id | 字符串 | 假 | 真正的 | Jira问题的id |
| issue_key | 字符串 | 假 | 真正的 | Jira事件的关键 |
| ticket_id | 整数 | 假 | 真正的 | Zendesk机票的id亚博 |
| updated_at | 字符串 | 真正的 | 假 | 链接最后更新的时间 |
| url | 字符串 | 假 | 假 | 获取链接详细信息的url |
Jira集成使用issue_id识别一个问题。issue_id被用过了issue_key因为issue_id是不可变的。一个issue_key将问题转移到其他项目后可能会更改。您可以使用说明获取issue的ID在这里或者通过Jira REST API:云，服务器．
issue_key也是强制性的，因为它用于支持将问题键同步到票据。您可以阅读更多关于字段同步特性的信息在这里．
例子
{“created_at”：“2017 - 01 - 01 t09:30:00z”，“id”：1234，“issue_id”：“5460”，“issue_key”：“测试- 5460”，“ticket_id”：5000，“updated_at”：“2017 - 01 - 01 t09:30:00z”}
列表的链接
GET / api / v2 / jira /链接
列出当前帐户的链接，按id排序。
允许
- 管理员
分页
默认情况下，该端点每个页面检索1000个链接。您可以对可用链接进行分页，并使用控件的组合自定义页面大小页面(后)和页面(大小)参数。
参数
| 名字 | 类型 | 在 | 要求 | 描述 |
|---|---|---|---|---|
| 过滤器(ticket_id) | 整数 | 查询 | 假 | 通过指定票证id或问题id，列出特定Zendesk票亚博证或Jira问题的链接。目前不支持按问题键进行过滤 |
| 页面(后) | 整数 | 查询 | 假 | 当提供时，返回的分页数据的第一项必须是结果列表中紧跟在游标之后的项。例外:如果结果列表中没有落在游标之后的项，则返回的分页数据必须是空数组 |
| 页面(大小) | 整数 | 查询 | 假 | 将返回的条目数 |
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/v2/jira/links\- u{电子邮件}：{密码}#按票过滤链接旋度https://{子域名}.亚博zendesk.com/api/v2/jira/links ?过滤器［ticket_id]＝5000\- u{email_address}：{密码}
去
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://support.亚博zendesk.com/api/v2/jira/links?filter [ticket_id] = 5000和页面(后)= 1234和页面大小= 100”方法：=“获得”要求的事情，犯错：=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://support.亚博zendesk.com/api/v2/jira/links”）．newBuilder（）．addQueryParameter（“过滤器(ticket_id)”，“5000”）．addQueryParameter（“页面(后)”，“1234”）．addQueryParameter（“页面大小”，“100”）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs
varaxios＝需要（“axios”）；var配置＝{方法：“得到”，url：“https://support.亚博zendesk.com/api/v2/jira/links”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，参数个数：{“过滤器(ticket_id)”：“5000”，的页面(后)：“1234”，页面(大小)的：“100”，}，}；axios（配置）．然后（函数（响应）{控制台．日志（JSON．stringify（响应．数据））；}）．抓（函数（错误）{控制台．日志（错误）；}）；
Python
进口请求url＝“https://support.亚博zendesk.com/api/v2/jira/links?filter [ticket_id] = 5000和页面(后)= 1234和页面大小= 100”头＝{“内容类型”：“application / json”，}响应＝请求．请求（“获得”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头）打印（响应．文本）
鲁比（人名）
需要“net/http”uri＝URI（“https://support.亚博zendesk.com/api/v2/jira/links”）uri．查询＝URI．encode_www_form（“过滤器(ticket_id)”：“5000”，“页面(后)”：“1234”，“页面大小”：“100”）请求＝网：：HTTP：：得到．新（uri，“内容类型”：“application / json”）请求．basic_auth“用户名”，“密码”响应＝网：：HTTP．开始uri．主机名，uri．港口，use_ssl：真正的做|http|http．请求（请求）结束
示例响应(年代)
200好了
//状态200 OK{“链接”：［{“created_at”：“2017 - 01 - 01 t09:30:00z”，“id”：1234，“issue_id”：“5460”，“issue_key”：“测试- 5460”，“ticket_id”：5000，“updated_at”：“2017 - 01 - 01 t09:30:00z”}]，“元”：{“after_cursor”：“https://{子域名}.zendes亚博k.com/api/v2/jira/links ?页面(后)= 5000”，“has_more”：真正的}}
显示链接
GET / api /服务/ jira /联系/ {link_id}
检索单个链接。
允许
- 管理员
参数
| 名字 | 类型 | 在 | 要求 | 描述 |
|---|---|---|---|---|
| link_id | 整数 | 路径 | 真正的 | 链路id |
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/services/jira/links/{id}\- u{电子邮件}：{密码}
去
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://support.亚博zendesk.com/api/services/jira/links/1234”方法：=“获得”要求的事情，犯错：=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://support.亚博zendesk.com/api/services/jira/links/1234”）．newBuilder（）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs
varaxios＝需要（“axios”）；var配置＝{方法：“得到”，url：“https://support.亚博zendesk.com/api/services/jira/links/1234”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，}；axios（配置）．然后（函数（响应）{控制台．日志（JSON．stringify（响应．数据））；}）．抓（函数（错误）{控制台．日志（错误）；}）；
Python
进口请求url＝“https://support.亚博zendesk.com/api/services/jira/links/1234”头＝{“内容类型”：“application / json”，}响应＝请求．请求（“获得”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头）打印（响应．文本）
鲁比（人名）
需要“net/http”uri＝URI（“https://support.亚博zendesk.com/api/services/jira/links/1234”）请求＝网：：HTTP：：得到．新（uri，“内容类型”：“application / json”）请求．basic_auth“用户名”，“密码”响应＝网：：HTTP．开始uri．主机名，uri．港口，use_ssl：真正的做|http|http．请求（请求）结束
示例响应(年代)
200好了
//状态200 OK{“链接”：{“created_at”：“2017 - 01 - 01 t09:30:00z”，“id”：1234，“issue_id”：“5460”，“issue_key”：“测试- 5460”，“ticket_id”：5000，“updated_at”：“2017 - 01 - 01 t09:30:00z”，“url”：“https://subdomain.亚博zendesk.com/api/services/jira/links/1234”}}
创建链接
POST / api /服务/ jira /链接
创建链接。
允许
- 管理员
例子的身体
{“链接”：{“issue_id”：“5461”，“issue_key”：“测试- 5461”，“ticket_id”：5001}}
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/services/jira/links\- d“{”链接”:{“ticket_id”:5001年,“issue_id”:“5461”,“issue_key”:“测试”- 5461}}”\- h“application / json内容类型:\- u{email_address}：{密码}- x的帖子
去
进口（“fmt”“输入输出”“net/http”“弦”）函数主要（）{url：=“https://support.亚博zendesk.com/api/services/jira/links”方法：=“职位”有效载荷：=字符串．NewReader（”{“链接”:{“issue_id”:“5461”,“issue_key”:“测试- 5461”,“ticket_id”:5001}} '）要求的事情，犯错：=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://support.亚博zendesk.com/api/services/jira/links”）．newBuilder（）；RequestBody身体＝RequestBody．创建（MediaType．解析（“application / json”），”“＂{\”链接\”：{issue_id \“\”：\”5461\”，issue_key \“\”：\”测试-5461\”，ticket_id \“\”：5001}}”“＂）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“职位”，身体）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs
varaxios＝需要（“axios”）；var数据＝JSON．stringify（{“链接”：{“issue_id”：“5461”，“issue_key”：“测试- 5461”，“ticket_id”：5001}}）；var配置＝{方法：“职位”，url：“https://support.亚博zendesk.com/api/services/jira/links”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，数据：数据，}；axios（配置）．然后（函数（响应）{控制台．日志（JSON．stringify（响应．数据））；}）．抓（函数（错误）{控制台．日志（错误）；}）；
Python
进口请求进口jsonurl＝“https://support.亚博zendesk.com/api/services/jira/links”有效载荷＝json．加载（”““{“链接”:{“issue_id”:“5461”,“issue_key”:“测试- 5461”,“ticket_id”:5001}}”“”）头＝{“内容类型”：“application / json”，}响应＝请求．请求（“职位”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头，json＝有效载荷）打印（响应．文本）
鲁比（人名）
需要“net/http”uri＝URI（“https://support.亚博zendesk.com/api/services/jira/links”）请求＝网：：HTTP：：帖子．新（uri，“内容类型”：“application / json”）请求．身体＝％问（{“链接”：{“issue_id”：“5461”，“issue_key”：“测试- 5461”，“ticket_id”：5001}}）请求．basic_auth“用户名”，“密码”响应＝网：：HTTP．开始uri．主机名，uri．港口，use_ssl：真正的做|http|http．请求（请求）结束
示例响应(年代)
201年创建
//状态201创建{“链接”：{“created_at”：“2017 - 01 - 01 t09:30:00z”，“id”：1234，“issue_id”：“5460”，“issue_key”：“测试- 5460”，“ticket_id”：5000，“updated_at”：“2017 - 01 - 01 t09:30:00z”，“url”：“https://subdomain.亚博zendesk.com/api/services/jira/links/1234”}}
删除链接
删除/ api /服务/ jira /联系/ {link_id}
删除给定的链接。
允许
- 管理员
参数
| 名字 | 类型 | 在 | 要求 | 描述 |
|---|---|---|---|---|
| link_id | 整数 | 路径 | 真正的 | 链路id |
代码示例
旋度
旋度https://{子域名}.亚博zendesk.com/api/services/jira/links/{id}\- u{email_address}：{密码}- x删除
去
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://support.亚博zendesk.com/api/services/jira/links/1234”方法：=“删除”要求的事情，犯错：=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://support.亚博zendesk.com/api/services/jira/links/1234”）．newBuilder（）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“删除”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs
varaxios＝需要（“axios”）；var配置＝{方法：“删除”，url：“https://support.亚博zendesk.com/api/services/jira/links/1234”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，}；axios（配置）．然后（函数（响应）{控制台．日志（JSON．stringify（响应．数据））；}）．抓（函数（错误）{控制台．日志（错误）；}）；
Python
进口请求url＝“https://support.亚博zendesk.com/api/services/jira/links/1234”头＝{“内容类型”：“application / json”，}响应＝请求．请求（“删除”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头）打印（响应．文本）
鲁比（人名）
需要“net/http”uri＝URI（“https://support.亚博zendesk.com/api/services/jira/links/1234”）请求＝网：：HTTP：：删除．新（uri，“内容类型”：“application / json”）请求．basic_auth“用户名”，“密码”响应＝网：：HTTP．开始uri．主机名，uri．港口，use_ssl：真正的做|http|http．请求（请求）结束
示例响应(年代)
204无内容
//状态204无内容零
列表链接(已弃用)
GET / api /服务/ jira /链接
请注意:此端点已弃用。使用列表的链接端点(GET / api / v2 / jira /链接)。
列出当前帐户的链接，按id排序。
分页
默认情况下，该端点每个页面检索1000个链接。的组合来自定义页面大小since_id和限制参数。
参数
| 名字 | 类型 | 在 | 要求 | 描述 |
|---|---|---|---|---|
| 限制 | 整数 | 查询 | 假 | 将返回的条目数 |
| since_id | 整数 | 查询 | 假 | 集合的开始id |
| ticket_id | 整数 | 查询 | 假 | 提供特定Zendesk Ticket或Jira问题的亚博链接ticket_id和/或issue_id参数。我们目前不支持issue_key参数。 |
代码示例
旋度
旋度- u{电子邮件}：{密码}- x得到\https://{子域名}.亚博zendesk.com/api/services/jira/links#按票过滤链接旋度- u{email_address}：{密码}\https://{子域名}.亚博zendesk.com/api/services/jira/links ? ticket_id＝5000
去
进口（“fmt”“输入输出”“net/http”）函数主要（）{url：=“https://support.亚博zendesk.com/api/services/jira/links?limit=100&since_id=1234&ticket_id=5000”方法：=“获得”要求的事情，犯错：=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://support.亚博zendesk.com/api/services/jira/links”）．newBuilder（）．addQueryParameter（“限制”，“100”）．addQueryParameter（“since_id”，“1234”）．addQueryParameter（“ticket_id”，“5000”）；请求请求＝新请求．构建器（）．url（urlBuilder．构建（））．方法（“获得”，零）．addHeader（“内容类型”，“application / json”）．addHeader（“授权”，凭证．基本（“电子邮件”，“你的密码”））．构建（）；响应响应＝客户端．newCall（请求）．执行（）；
Nodejs
varaxios＝需要（“axios”）；var配置＝{方法：“得到”，url：“https://support.亚博zendesk.com/api/services/jira/links”，头：{“内容类型”：“application / json”，“授权”：的基本< auth-value >”，// Base64编码的"username:password"}，参数个数：{“限制”：“100”，“since_id”：“1234”，“ticket_id”：“5000”，}，}；axios（配置）．然后（函数（响应）{控制台．日志（JSON．stringify（响应．数据））；}）．抓（函数（错误）{控制台．日志（错误）；}）；
Python
进口请求url＝“https://support.亚博zendesk.com/api/services/jira/links?limit=100&since_id=1234&ticket_id=5000”头＝{“内容类型”：“application / json”，}响应＝请求．请求（“获得”，url，身份验证＝（“<用户名>”，' <密码> '），头＝头）打印（响应．文本）
鲁比（人名）
需要“net/http”uri＝URI（“https://support.亚博zendesk.com/api/services/jira/links”）uri．查询＝URI．encode_www_form（“限制”：“100”，“since_id”：“1234”，“ticket_id”：“5000”）请求＝网：：HTTP：：得到．新（uri，“内容类型”：“application / json”）请求．basic_auth“用户名”，“密码”响应＝网：：HTTP．开始uri．主机名，uri．港口，use_ssl：真正的做|http|http．请求（请求）结束
示例响应(年代)
200好了
//状态200 OK{“链接”：［{“created_at”：“2017 - 01 - 01 t09:30:00z”，“id”：1234，“issue_id”：“5460”，“issue_key”：“测试- 5460”，“ticket_id”：5000，“updated_at”：“2017 - 01 - 01 t09:30:00z”}]}