我本来是想写篇文章,吐槽一下jira的api的,但是发现最终jira api,很多地方又让我学到了一些新知识。有些方面真的是没见过这么标准使用的。...本来我以为在国内有很多公司都在用jira, 这里面少不了的API接口进行功能性的封装,肯定会有中文的文档结果经过几次尝试搜索之后,我终于确认jira API是没有中文文档的。...没有人完整的翻译过jira API的文档,然后我发现了一个巨坑的事情:jira App文档分嗯多个版本,基本上每一个版本的基拉就对应一个版本的API文档,我没有仔细去看这里面的区别,但是我觉得一个版本一个文档...大家如果有机会对接jira API文档,到时候一定要首先确认jira的版本。 HTTPcode 在jira API文档中,http协议响应状态码有很多使用。..."self": "http://www.example.com/jira/rest/api/2/user?
三.具体查询 查询JIRA的project信息 #查询project信息 print (jira.projects()) #获取所有的projets project =jira.project('...print (project.description) #项目描述 print (project.components) #获取项目组件 print (project.raw) #获取项目的原始API...数据 print (project.projectCategory) #获取项目分类 查询JIRA的issue信息 可以查询到信息有: 所属项目 问题类型和状态 标题和描述 干系人 时间点 附件和评论等...issue.fields.project) #所属项目 print (issue.fields.issuetype) #问题类型 print (issue.fields.status) #问题状态...搜索Jira issue Jira有一套专门的搜索语言,称为JQL(Jira Query Language),Jira的Python库便是基于JQL语法进行搜索的,返回的是搜索到的问题列表。
一.简介 在jira操作中有些联动需求,例如需要查询一些数据并展示,在自带的筛选器中只能做单项操作,没法将多种查询进行自定义展示。通过API将查询结果进行自定义编排展示。...再例如需要在有新的任务分配给自身时进行提醒,可能有插件做到邮件提醒,但邮件就目前2020年来说越来越不适合做提醒功能,大量邮件会污染邮箱的,可以通过API去钉钉、企业微信等API联动提醒。...官方API python-jira 二.初始化 1.安装模块 pip3.6 install jira 2.JIRA都有访问限制,在访问Jira项目时首先要进行认证,Jira Python库提供了3种认证方式...: 通过Cookis方式认证(用户名,密码) 通过Basic Auth方式认证(用户名,密码) 通过OAuth方式认证 用最简单的认证方式 from jira import JIRA # 通过jira域名和账户密码登录...jira = JIRA('https://jira.xxx.xxx/', basic_auth=('user_name', 'password')) 3.在筛选器对需要的结果进行筛选,点高级拿到sql
Elasticsearch 里的接口都是通过 REST 接口来实现的。 Index PUT twitter/_doc/1?...ES 也提供了相应的 REST 接口。...Delete doc 删除一个文档的话,我们可以使用如下的命令: DELETE twitter/_doc/1 通过查询的方式来进行查询,然后进行删除。ES 也提供了相应的 REST 接口。...来进行更新一个文档: POST _bulk { "update" : { "_index" : "twitter", "_id": 2 }} {"doc": { "city": "长沙"}} 注意:通过 bulk API...这样做可能会导致严重的性能问题。
REST API REST(表述性状态传输)API 是一种应用程序接口 (API) 的架构风格,它使用 HTTP 请求来访问和使用数据。...GraphQL 与 REST: GraphQL 和 REST API 之间的主要区别在于 GraphQL 是一种查询语言,而 REST 是一种基于网络的软件的架构概念。...可用性 REST API 使用 URI 和 HTTP 技术,这使得 API 很难预测在联系新端点时会发生什么。REST 中缺少指定的版本控制要求允许提供者采用他们自己的方法。...因此,无法像 REST API 那样缓存查询。 但是,由于可用的工具,客户端缓存优于 REST。...与 REST API 相比,这是一个明显的区别,在 REST API 中,每个 状态代码都指向某种类型的响应。
理解和使用内容协商 我们的开发者在发送一个 REST API 请求的同时,根据应用场景,针对相同的资源,可能会期待不同的返回形式。 比如,我希望根据用户客户端语言,同一个资源的内容可以返回不同的语言。...IBM developerWorks 的文件服务标签云的 API REST API 请求,要求返回 XML 格式数据: GET https://www.ibm.com/developerworks...使用 HTTP 头进行缓存处理 在 REST 的构架中,我们除了在与后台的数据交换中,需要有一个良好的缓存机制外,针对 REST API 请求都是在远端用 HTTP 发起这一特点,还需要为网络缓存进行更多考虑...条件请求与电子标签: 很多时候,数据内容可能会几个小时甚至几天都不会发生变动,这个时候根据请求时间间隔来控制缓存,就不能满足系统的需求了。通过支持条件请求与电子标签,可以帮助我们来解决这个问题。...,可以帮助我们更好的设计 REST API: 批量更新: 当用户需要更新多个资源的时候,你打算让开发者一次次的发送 HTTP 请求逐个更新吗?
稍稍总结了些经验,在这篇文章里讲讲如何撰写「合格的」REST API。 RFC一致性 REST API一般用来将某种资源和允许的对资源的操作暴露给外界,使调用者能够以正确的方式操作资源。...Headers 很多REST API犯的比较大的一个问题是:不怎么理会request headers。...一个合格的REST API需要根据Accept头来灵活返回合适的数据。...Etag能把绝大多数integrity的问题扼杀在摇篮中,当然,race condition还是存在的:如果B的修改还未进入数据库,而A的修改请求正好通过了Etag的验证时,依然存在一致性问题。...一般而言,如果对REST API的安全性要求比较高,那么,所有的API的所有操作均需得到授权。
这里我们不得不提到REST API。...另外,REST API的书籍很多,但是完整完善实践丰富的设计指导并不多见,我们有幸看到了微软团队的作品——Microsoft REST API Guidelines,因此才有了此篇内容。...翻译的不对之处,请多多指教。 什么是REST API?...简单的来说,在REST API:URL定位资源,用HTTP动词(GET,POST,PUT,DELETE)描述操作。前面说了,REST 指的是一组架构约束条件和原则。...那么满足这些约束条件和原则的应用程序或设计就是 RESTful。 为什么用REST API? 1.前后端分离主要以API为界做接洽的,这样就会有很多的API,API的表现力更强,更加便于理解。
因此,这些准则的一个目标是确保任何支持基本 HTTP 协议的客户端都可以简单且一致地使用 Microsoft REST API。...本文档建立了 Microsoft REST API 开发人员应该遵循的指南, 以便统一一致地开发 API。...允许Service服务开发人员利用其他Service服务的基础来开发一致的 REST API 节点。 允许合作伙伴 (如非微软团队) 使用这些准则来设计自己的 REST API。...这些准则适用于 Microsoft 或其合作伙伴公开发布的所有 REST API 服务。...显然,实现或必须与某些外部定义的 REST API 互操作的 REST 服务必须与那些 API 兼容,而无法遵循这些准则。
The Representational State Transfer (REST)架构风格不是可以购买的技术,也不是可以添加到软件开发项目中的库。...“无状态”这个术语是一个至关重要的部分,因为它允许应用程序以不一样的方式进行通信。 一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求,每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。 对于与RESTful API的编程交互,可以使用十几种或更多的客户端API或工具。...尽管您可以用任何一种方法解决许多架构问题,但它们并不是可以互换使用的。 这种混乱很大程度上源于一种误解,即REST“关于通过url调用Web服务”。这个想法与RESTful架构的功能根本不相符。...如果没有对RESTful架构实现的更宏观的理解,很容易失去实践的意图。 REST最好用于管理系统,通过将产生和使用它的技术产生和使用的信息解耦。
大家好,又见面了,我是你们的朋友全栈君。 The Representational State Transfer (REST)架构风格不是可以购买的技术,也不是可以添加到软件开发项目中的库。...“无状态”这个术语是一个至关重要的部分,因为它允许应用程序以不一样的方式进行通信。 一个RESTful API服务通过统一资源定位器(URL)公开。这个逻辑名称将资源的标识与所接受或返回的标识分开。...这是最常见的请求,每次在浏览器中键入URL并单击return、选择书签或单击锚点引用链接时执行。 对于与RESTful API的编程交互,可以使用十几种或更多的客户端API或工具。...尽管您可以用任何一种方法解决许多架构问题,但它们并不是可以互换使用的。 这种混乱很大程度上源于一种误解,即REST“关于通过url调用Web服务”。这个想法与RESTful架构的功能根本不相符。...如果没有对RESTful架构实现的更宏观的理解,很容易失去实践的意图。 REST最好用于管理系统,通过将产生和使用它的技术产生和使用的信息解耦。
Microsoft REST API指南 摘要 Microsoft REST API指南作为一种设计原则,鼓励应用程序开发人员通过RESTful HTTP接口访问资源。...本文档建立了 Microsoft REST API 开发人员应该遵循的指南, 以便统一一致地开发API。...允许Service开发者利用其他Service的基础上来开发一致的REST API端点。 允许合作伙伴(例如,非Micosoft团队)使用这些准则来设计自己的 REST API。...如:实现或必须与某些外部定义的REST API互操作的REST服务必须与哪些外部的API兼容,而无法遵循这些准则。而还有一些服务也可能具有需要特殊性能需求,必须采用其他格式,例如二进制协议。...符合Microsoft REST API准则的API应该支持PATCH。 7.4.3.
前言 Yarn Rest Api 返回的数据都是XML格式,需要解析XML。...每秒消耗的内存总和 vcoreSecond string 所有的container每秒消耗的核心数总和 queueUsagePercentage double 所属队列的资源使用百分比 clusterUsagePercentage...appsCompleted int 完成的应用程序数量 appsPending int 等待的应用程序数量 appsRunning int 正在运行的应用程序数量 appsFailed int 失败的应用程序数量...appsKilled int 被杀死的应用程序数量 reservedMB long 保留的内存量(MB) availableMB long 可用的内存量(MB) allocatedMB long 分配的内存量...int 不良节点数 decommissioningNodes int 停用的节点数 decommissionedNodes int 退役的节点数 rebootedNodes int 重新启动的节点数
REST API示例 在你的浏览器中打开以下链接,从Open Trivia Database[3]中请求一个随机的计算机问题: https://opentdb.com/api.php?...amount=1&category=18[4] 这是一个作为RESTful网络服务实现的公共API(它遵循REST公约)。你的浏览器将展示一个单独的JSON格式的问答问题,并附有答案。...为了避免兼容性问题,API通常是有版本的。例如,/2.0/user/123取代了/user/123。新的和旧的端点都可以保持活跃。不幸的是,这样就有必要维护多个历史API。...最多组成10个/author/{id}请求以获取每个作者的详细信息。 这被称为「N+1问题」;必须为父请求中的每个结果提出N个API请求。...你的客户不太可能有与Facebook类似的问题,所以一旦RESTful API发展到超出其实际限制时,GraphQL可能值得考虑。
前言 前面我们说了,如果API的设计更规范更合理,在很大程度上能够提高联调的效率,降低沟通成本。那么什么是好的API设计?这里我们不得不提到REST API。...关于REST API的书籍很多,但是完整完善实践丰富的设计指导并不多见,我们有幸看到了微软团队的作品——Microsoft REST API Guidelines,因此才有了此篇内容。...上篇内容: REST API设计指导——译自Microsoft REST API Guidelines(三) 6 Client guidance 客户指导 To ensure the best possible...符合 Microsoft REST API 指南的 API 应该支持 PATCH 方法。...表的请求头应该遵循微软REST API服务规范。使用这些标头不是必须的,但是如果用到,那么它们必须使用一致。
前面我们说了,如果API的设计更规范更合理,在很大程度上能够提高联调的效率,降低沟通成本。那么什么是好的API设计?这里我们不得不提到REST API。...关于REST API的书籍很多,但是完整完善实践丰富的设计指导并不多见,我们有幸看到了微软团队的作品——Microsoft REST API Guidelines,因此才有了此篇内容。...5 Taxonomy 分类 As part of onboarding to Microsoft REST API Guidelines, services MUST comply with the taxonomy...Microsoft REST API 准则基本要求的一方面就是 服务的分类必须符合以下定义。...错误不会影响整体 API 的可用性。 译者注:错误可以理解成客户端参数错误,通常返回“4XX”状态码,并不影响整体的API使用。
什么是 RESTful API 首先,想问一个问题,你的项目里真的有真正的 RESTful API 吗? 如果你认为你的项目有 RESTful API,那么你很可能错了。...RESTful API 背后的思想是遵循REST 规范中描述的所有架构规则和限制的方式进行开发。然而,实际上,这在实践中基本上是不可能的。 一方面,REST 包含了太多模糊和模棱两可的定义。...REST API 规范能做什么? 尽管存在上面说到的缺点,但使用合理的方法,REST 仍然是创建真正优秀 api 的一个绝佳选择。...因为你通过高质量的 API 规范实现的 api 将会是一致的,具有清晰的结构、良好的文档和高的单元测试覆盖率。 通常,REST API规范与其文档相关联。...这将使使用你的 API 的开发人员感到轻松,并且肯定比手工填写 REST API 文档模板要好。
大家好,又见面了,我是你们的朋友全栈君。 REST API 优点: 1. 轻量级的解决方案,不必向SOAP那样要构建一个标准的SOAP XML。 2....可读性比较好:可以把URL的名字取得有实际意义。 3....不需要SDK支持:直接一个Http请求就可以,但是SOAP则可能需要使用到一些Webservice的类库(例如Apache的Axis) 缺点: 1....复杂的应用中,URL可能非常长,而且不容易解析。 SOAP API 优点: 1. 定义严格。必须符合SOAP的格式 2. 某些时候使用比较方便 3. 开发工具支持比较多一点。
RESTful 接口 URL 的格式是: http://cluster的地址: 9200/II [] 其中,index, type 是必须提供的( index 可以理解为数据库...;type 理解为数据表); id 是可选的(相当于数据库表中记 录的主键是唯一的。...增 、删、改,查分别对应 HTTP 请求的 PUT 、DELETE、POST、GET方法。 Kibana DevTools ?...image.png 创建数据 创建index是province,type是citys ,当前id为1的document数据 PUT /province/citys/1 { "name":"北京",...v 查看es的index GET _cat/indices
Rest风格API Elasticsearch提供了Rest风格的API,即http请求接口 基本概念 Elasticsearch也是基于Lucene的全文检索库,本质也是存储数据,很多概念与MySQL...,代表许多的索引 类型(type):类型是模拟mysql中的table概念,一个索引库下可以有不同类型的索引,比如商品索引,订单索引,其数据格式不同。...ES中所存数据的文件块,也是数据的最小单元块。假如有2个分片,插入10条数据,默认,每个分片存5条。...,类似于数据库中的表 字段名:类似于数据库中的列名。...但是有些字段是我们不希望被索引的,比如商品的图片信息,就需要手动设置index为false。 3)store 是否将数据进行额外存储。