跳至主要内容
所有作者的帖子

Jeff ErnstFriedman

金融服务提供商 Finxact 加入 Open API Initiative

作者 博客

本周,Finxact 宣布已成为 Open API Initiative 的正式成员。Finxact 与银行业合作开发开放银行 API。

Finxact 基于 OpenAPI 规范 (OAS) 与其社区共同开发开放银行 API。作为虚拟核心,第三方服务和银行的现有系统通过 Finxact 的开放银行 API 连接到 Finxact 的核心处理规则引擎和记录系统。

“OAI 及其不断扩大的董事会成员很高兴欢迎 Finxact 加入工作组。Finxact 将成为首家正式支持我们工作组开放、透明和互操作性使命的核心银行提供商,”OAI 主席 Ole Lensmar 说。“Finxact 及其合作伙伴正在进行开创性的贡献,这将使银行和金融科技公司能够使用 OpenAPI 规范 (OAS) 作为其交互的推动者,自由而透明地互操作。”

阅读完整的新闻稿 这里.

RepreZen 加入 Open API Initiative,宣布早期 OAS 3.0 工具支持

作者 博客

OpenAPI 规范 (OAS) 版本 2.0(以前称为 Swagger 规范)是当前 API 描述的行业标准,得到了数千个开源项目和所有主要 API 技术供应商的支持。而 OAS 版本 3.0,计划于 2017 年 7 月发布,是该规范的首次重大更新。

OpenAPI 3.0 可以用更高的精度和细节描述更广泛的现代 REST API。它提供了改进的组件重用、更灵活的消息模式以及新的 API 功能,如超链接和回调。

RepreZen 很高兴地宣布,我们的商业和开源软件中已提供对 OpenAPI 3.0 的实验性编辑支持,将这些新功能带到开发人员的桌面。我们的第一个实现基于当前的 草案规范,并使用 Gnostic OpenAPI JSON 模式,由 Google 的 Tim Burks 贡献。

RepreZen 加入 Open API Initiative

我们还很荣幸地宣布 RepreZen 现在是 Open API Initiative 的成员,我们将继续作为技术开发者社区的一部分,参与 OpenAPI 规范的工作。

与 OpenAPI 社区合作对我们来说是一次令人满意的经历,因为 SmartBear、Google、Microsoft 等公司拥有丰富的知识和思想领导力。他们兑现了保持该组织开放和供应商中立的承诺。并且通过 Swagger,他们继承了大量的实践知识,这些知识在 GitHub(和其他地方)的讨论线程中详细阐述,并提炼到 OpenAPI 规范 本身。

对于 RepreZen 团队来说,这正式认可了我们多年来的参与,以及我们对 OAS 作为行业标准 API 描述语言的支持。

对于我们的客户来说,加入 OAI 是我们对将 OAS 放在 RepreZen 产品和开源技术中心的承诺,以便不断创新和构建使 OpenAPI 为您工作的解决方案。

关于 OpenAPI 的过去和未来的思考

优秀的软件是关于在中间相遇。

如果您像我一样是一个有想法的人,您会从抽象的角度出发,用最大的洞察力和最少的实现细节来描述问题的本质和解决方案。您会寻找以机器可读形式表示它的最高级、最具表现力的方式,并且您会深入到实现细节,但仅限于您需要的那样远。

如果您是一个实用主义者,您会从最基本的、机械的方面开始,然后重构您的方式,直到得到更优雅的解决方案。 但是只有在优雅性开始自给自足时才会这样做。然后您会停下来,留待另一天处理粗糙的边缘,然后继续前进。

但是无论您从哪个角度出发,这是一个不断协调的过程。软件的演进意味着概念框架和代码的并行演进;并且不断地、巧妙地将它们编织在一起。您自上而下和自下而上工作,并在中间相遇。

OpenAPI 规范是一个很好的例子,说明了恰到好处的抽象 可以做些什么。它提供了一个更高层次的表现力,允许开发人员以资源、操作和数据模型为思考单位——熟悉的概念,在协议、控制器和类冠层之上舒适地滑翔。 而且您不必以高级语义、深奥的概念或宗教教条重新思考您的 API。

并且凭借丰富的商业和开源工具生态系统,开发人员可以选择自下而上工作,使用代码优先注解,或者自上而下工作,使用 API 描述语言。无论您从哪里开始,我们都可以通过 OpenAPI 规范在中间相遇。

让我们聊聊 API!

想要参与其中?我们的门是敞开的,我们喜欢听取用户的意见。

  • 联系我们,让我们知道您对 OpenAPI、RepreZen API Studio 和 KaiZen Editor 的看法。

RepreZen API Studio:面向 OpenAPI 开发的完整 IDE

RepreZen API Studio 是我们面向 API 优先设计、文档和开发的旗舰平台。

要开始使用,只需 注册免费试用,下载并安装。 在我们的支持网站上查看 常见问题解答文章 以开始使用。

KaiZen OpenAPI Editor:现在已上架 Eclipse 市场

KaiZen OpenAPI Editor 是 RepreZen 的开源、基于 Eclipse 的行业标准 OpenAPI 规范语言编辑器。这是与 RepreZen API Studio 中使用的相同功能齐全的编辑器,以前称为 SwagEdit。KaiZen OpenAPI Editor 是我们面向 OpenAPI 2.0 和 3.0 的核心编辑组件。

您现在就可以从 Eclipse 市场 安装到 Eclipse 桌面 IDE(Mars.2 版或更高版本)中进行试用。安装完成后,请查看 入门指南 以快速了解概况。

Ted Epstein
RepreZen 首席执行官
RepreZen 首席执行官 Ted Epstein 10 多年来一直致力于帮助组织简化、统一和协调其系统接口。Ted 领导 RAPID-ML 的架构,RAPID-ML 是第一个将协作数据建模功能引入 REST API 设计的 IDL。Ted 是 API-Craft NYC 聚会的联合组织者,并在 QCon、EclipseCon、API-Craft 和 Data Modeling Zone 等会议上发表过演讲。

Open API Initiative 启动 OpenAPI 规范大使计划

作者 未分类

Open API Initiative 很高兴地宣布创建 OAS 大使计划。

继最近发布 OpenAPI Spec V3 实现者草案的公告之后,OAI 希望帮助 OAS 实现者、开发人员、产品经理、自由职业者以及 OAI 会员和非会员构建和发展 OAS 社区。

如果您正在展示 OpenAPI 规范的成功案例,我们想请您吃披萨 - 或者您选择的类似的饮料。请联系我们并分享您的故事,Open API Initiative 将为您的聚会报销高达 500 美元的食品和饮料费用。

请联系 OAI 获取更多详细信息。

竞争对手加入 OAI 引领 API 环境的融合

作者 博客
随着 Mulesoft(RAML 的创始人)、Apiary(API Blueprint 的创始人)和 SmartBear(Swagger 的管理者)最近加入 Open API Initiative,Restlet 的 Jerome Louvel 抓住了这个机会,重新回顾了 OAI 和 API 规范的历史。

与其让这三种努力之间保持直接竞争,希望其中一种能够获胜并取代另外两种,不如找到一条更好的道路,这是必要也是可能的。我与这场故事的主要参与者关系密切,并且构建了像 Restlet Studio 这样的支持 OAS 和 RAML 的工具,并倾听我们的用户反馈,我意识到理想的情况是让 Apiary 和 MuleSoft 加入 Open API Initiative,并逐步推动这三种规范的融合,而不是合并。在 API 测试方面,也存在类似的标准化需求,但是除了 HAR(HTTP 归档)格式之外,只有专有格式可用,例如 Postman 集合或 JMeter 脚本。

阅读 Restlet 博客上的完整文章:Restlet 博客


 

 

注意:Restlet 是 OAI 的创始成员,并且最近加入了 RAML 工作组。

 

Jerome Louvel
Restlet 的首席技术官兼产品副总裁
Jerome Louvel 是 Restlet 的创始人、首席技术官兼产品副总裁,是 REST API 专家。Jerome 担任 Open API Initiative 商业管理委员会成员。

Open API Initiative 和 Linux 基金会将共同举办 APIStrat 17

作者 博客

Open API Initiative 与 Red Hat 的 3scale 和 API Evangelist 共同宣布,APIStrat 已成为 Linux 基金会活动。

API 策略与实践大会 - 将于 10 月 31 日至 11 月 2 日在美国俄勒冈州波特兰市举行 - 将由 Linux 基金会活动和 Open API Initiative (OAI) 联合举办。

在过去的七年里,APIStrat 由 3scale 组织,3scale 于 2016 年 6 月被 Red Hat 收购,Red Hat 将该活动捐赠给了 Linux 基金会。该大会的第八届活动将汇集各种与会者,从对 API 感兴趣的人到开发人员和 IT 团队、商业用户和高管,共同探讨 API 领域的机会和挑战。

“我们很高兴看到 APIStrat 加入 Linux 基金会和 Open API Initiative。自成立以来,该大会一直致力于为讨论最新的 API 主题提供一个中立、高质量的场所,我相信新组织团队将出色地管理它。与 Open API Initiative 一样,我们也致力于制定 API 定义的标准通用格式,将该活动过渡到新组织是合适的。”Red Hat API 基础设施高级主管兼联合创始人 Steven Willmott 说。

“经过七届活动,我很高兴看到 APIStrat 作为一场会议逐渐成熟,并成为 Open API Initiative (OAI) 的一部分。该活动一直是围绕 Open API(也称为 Swagger)进行讨论的论坛,因此 Linux 基金会是主办该会议的自然选择。”APIStrat 联合创始人兼 API Evangelist Kin Lane 说。

Linux 基金会在全球举办超过 100 场活动,让全球顶尖的技术专家聚首,共同合作和创新。

DevSum17:OpenAPI v3 - API 描述的演变

作者 活动

DevSum17
瑞典斯德哥尔摩
2017 年 6 月 8-9 日


OpenAPI V3 的工作即将完成。曾经广受欢迎的 Swagger 已演变成规范的新版本,它在 Linux 基金会的支持下,得到了许多大型科技公司的支持。

Open V3 进行了许多改进,并添加了新功能,可以帮助您描述您的 API。这些改进将使开发人员能够描述以前无法用 Swagger 描述的许多 HTTP API,并最终生成更好的客户端库和更好的文档。

无论您是 OpenAPI 的新手还是有丰富的 Swagger 使用经验,这个演讲都包含大量关于如何使用 OpenAPI 及其新功能的信息。这个演讲不仅会向您介绍发生了哪些变化,还会深入探讨做出这些变化的原因。

快来加入我吧,让 OpenAPI 将您的 API 提升到一个新的高度。

级别: 中级

 

Open API Initiative 宣布发布 OpenAPI 规范 v3 实现者草案

作者 博客

大约一个月前,我们承诺发布 OpenAPI 规范 (OAS) 的第一个实现者草案,现在它已经发布了!按照我们的官方版本控制方案,这个版本称为 3.0.0-rc0。这是发布规范最终版本的重要一步。

在最终版本发布之前,规范的进一步开发将在 OpenAPI.next 分支 中继续进行。3.0.0-rc0 版本已 标记 作为固定参考。

自我们 上一篇博文 以来,我们已经解决了规范中剩余的结构性更改,并澄清了一些问题和疑虑,并改进了文档。自那以后,一些值得注意的更改包括:

  • 最终确定了对 URL 模板的支持。
  • 重新设计了对 'multipart/*' 和 'x-www-form-urlencoded' 的支持,改变了文件上传的处理方式,并删除了 'file' 类型和 'formData' 参数类型。
  • 请求主体现在正式 不支持 行为未定义的 HTTP 动词。
  • 澄清了相对 URL 作为值的处理方式。
  • 回调的表达式语言已重新设计。
  • 示例文档已澄清。
  • Schema 对象已更新,以支持 'nullable' 以用于 null 传输值,并添加了 writeOnly 属性。
  • 对 JSON Schema 的支持已更新为 draft-wright-json-schema-00 版本(也称为 Draft 05)。OAS 实现与 JSON Schema 之间的差异已澄清。
  • Header 对象已更新,以遵循与 Parameter 对象类似的标准。结果删除了 Items 对象。

目前,规范已“功能完备”,这意味着我们不会积极讨论添加对现有票证的支持。在接下来的几周内,我们将关闭已处理的票证,或将它们标记为将来版本。

下一步是什么?

实现者草案标志着规范第三代的转折点。正如我们在 2.0 版本中所观察到的,没有工具,规范就毫无意义;没有规范,工具就毫无意义。这个草案意味着所有重大更改都已完成,并且鼓励工具作者构建基于它的工具,因为可以预见从现在开始只有很小的更改。就像 2.0 版本一样,这是一个早些参与并让您的项目受到关注的好机会。这也是参与 OpenAPI 社区并帮助推动规范发布的有意义的方式。

这意味着球在你的球场上。以下是如何提供帮助:

  • 编写您自己的工具来添加对规范的支持 - 毕竟它是实现者草案。这是我们了解这些更改的效果以及推出内容是否可使用且可以完全实现的唯一途径。正在开发此类工具?在 OpenAPI 规范存储库 中提交问题,让我们知道!
  • 查找规范中的技术问题:规范各部分之间的矛盾、不合理的功能、我们没有考虑到的用例。务必跟踪主题的线程和 PR,查看当前实现是否有现有的理由。
  • 查找规范中的内容问题:缺少句号、错别字、错误示例、措辞不当等等。

对贡献最多的贡献者,Open API Initiative 将提供一份感谢礼物。

与之前一样,我们可能会要求您对特定票证做出贡献或反馈 - 这些票证将被标记为 '需要帮助'。留意这些票证,不要害怕加入讨论。

感谢所有为这一重大进展做出贡献的人,并期待最终发布 OpenAPI 规范 3.0.0 版本。

技术开发人员社区

Tony Tam
SmartBear Software 的 Swagger 产品副总裁
Jeremy Whitlock
Google 的软件工程师
Ron Ratovsky
SmartBear 软件的 Swagger 开发者布道师
Darrel Miller
微软软件开发人员
Marsh Gardiner
谷歌产品经理
Jason Harmon
Typeform 的 API 主管

新年新规范

作者 博客

这是一段激动人心的旅程,我们很高兴地宣布 OpenAPI 规范 3.0 版本即将发布!

Image from the most recent Meeting of the Open API Initiative Technical Developer Community Meeting

来自最近一次 OpenAPI Initiative 技术开发者社区会议的图片

在过去的一年里,技术开发者社区 (TDC) 筛选了数百张票据和数千条评论——所有这些都是为了综合社区成员的需求,改进 2.0 规范以更好地服务他们。我们倾听了,辩论了,达成了一致,也产生了分歧,但始终保持规范的简洁和实用性,同时又保持其强大功能。下一个重要的里程碑将是第一个实施者草案,它将在 **2017 年 2 月 28 日** 发布。

更改

在过去几个月里,我们通过一系列博客文章、演讲,当然还有规范本身的更改,宣布了即将在规范中进行的更改。以下是关于一些更显著更改的简要回顾。

  • 重新排列了规范的结构,以方便和扩展重用。
  • 扩展了 JSON Schema 支持,包括 `oneOf`、`anyOf` 和 `not` 支持。
  • 更改了参数的结构,允许在其中使用 schema。
  • 增加了对 Cookie 参数的支持,并取消了 dataForm 参数。
  • 将主体参数提取到它们自己的实体中。
  • 增加了对内容类型协商的支持。
  • 引入了一种新格式,允许在响应和未来请求之间进行静态链接。
  • 简化和增强了 API 的安全定义。
  • 添加了回调机制来描述 WebHook。

为了帮助工具开发人员,我们还致力于规范的语义版本控制。这意味着对规范的任何更改都会触发版本更新,从而更轻松地管理和控制。

实施者草案

经过对规范的如此多的努力,是时候让开发人员开始证明其在现实世界场景中的使用了。因此,这个实施者草案是迈向最终版本的重要一步。随着更广泛的受众提供反馈并解决任何由此产生的问题,它将使我们最终发布。今天,我们呼吁您开始使用规范,并帮助我们确保它以最高质量实现其目标。

下一步

这也意味着不再应在规范中引入重大更改。这并不意味着规范已完全准备好,但我们已开始专注于清理文档,以帮助使新规范更易于使用。

因此,在接下来的几周内,TDC 将集中精力关闭已解决的票据并为未来版本标记票据。我们还将验证规范是否包含所有必要的信息,包括澄清说明和示例(在适当的情况下)。

作为社区成员(是的,您!),请查找标记为“需要帮助”的任何票据,这些票据表明需要帮助解决未解决的问题。一如既往,请随时提交额外的票据和 PR,无论发布状态如何。