APIs.guru加入了越来越多的API索引

2016 年 6 月 16 日

APIs.guru 是最新的获取 API 定义索引、内容管理和空间发现的方法。

这个开源的(MIT 许可证下)社区现在正在管理包括 236 种 API 描述的索引,其中覆盖了 6271 个端点。APIs.guru 致力于变成“REST API 中的维基百科”。

APIs.guru 正在进入一个持续拥挤的市场,其中还有别的 API 索引网站,包括 The API Stack API Commons APIs.io AnyAPI 和更老的索引例如 ProgrammableWeb’s API Directory 。这些 API 索引都有一个共同的目标, APIEvangelist.com 的博客主 Kin Lane 说道:

全世界的开发者都在他们的工作中使用这些定义,并且现代化的 API 工具和服务提供商也在使用它们定义自己需要展示的内容。为了帮助 API 行业达到下一个层次的目标,我们需要你走近并且与 API Stack、APIs.io 或 APIs.guru 分享你拥有的 API 定义,并且如果你有时间和能力,我们希望您也能帮助我们一起为现在能使用的受欢迎的服务整合其他新的 API 定义。

APIs.guru 的目录主要是由它的创造者 Ivan Goncharov 在管理。据一个 DataFire 博客的入口中说,最初版本的目录的构建方式是“使用自动抓取和人工管理相结合的方式来爬取网络中可用计算机处理的 API 定义”。

而这些提交与下面的评估标准不符:

  • 过滤掉私有的或者不可信赖的 API
  • 将不同的格式转换到统一的 OpenAPI(fka Swagger)2.0 格式
  • 修正错误,其中约 80% 的说明有一些错误
  • 加入额外的数据,例如:logo、种类等
  • 每日对一些说明定义进行更新

这个索引本身可以通过 GitHub Pages 中一个独立的 JSON 文件看到:https://api.apis.guru/v2/list.json

这个文件包含了一个 JSON 对象,其中的格式将 API 的 ID 作为键:<provider>[:<service>]。每个 API 描述的内容都包含:描述是什么时候加入的,现在推荐使用的 API 版本是什么,以及它的服务在 OpenAPI 文档中的链接(之前它以 Swagger 的名字为人熟知)。还有一个相对自由的格式叫做info对象,其中包含了基本的标题和描述信息,连同x-*键存放不同 API 提供者的具体信息。

除 API 索引之外的东西可以通过一个添加API 的页面获取到,其中在GitHub 上的 APIs-guru/api-models 库中开放了一个问题。一旦添加,提及的 API 说明定义就会从提交的格式( RAML API Blueprint WADL 等)被转化到 OpenAPI 2.0 的格式。最后,一个日常脚本会运行,来监控源 API 定义的更新。

查看英文原文 APIs.guru Joins Growing List of API Indexes


感谢张龙对本文的审校。

给InfoQ 中文站投稿或者参与内容翻译工作,请邮件至 editors@cn.infoq.com 。也欢迎大家通过新浪微博( @InfoQ @丁晓昀),微信(微信号: InfoQChina )关注我们。

2016 年 6 月 16 日 19:00698
用户头像

发布了 26 篇内容, 共 53777 次阅读, 收获喜欢 0 次。

关注

评论

发布
暂无评论
发现更多内容

开源数据库这么香,为什么我们还要下功夫自研?

华为云开发者社区

数据库 开源 数据

区块链是一个不知道要解决什么问题的解决方案吗?

CECBC区块链专委会

比特币 区块链 银行

31道Java核心面试题,一次性打包送给你

小Q

Java 学习 程序员 架构 面试

区块链教育 丨 首批区块链专业新生正式入学

CECBC区块链专委会

区块链技术 区块链教育

架构1期第四周作业1-大型互联网系统技术梳理

道长

架构师训练营第 1 期

JDK 中的栈竟然是这样实现的?

王磊

Java 数据结构和算法

LeetCode题解:104. 二叉树的最大深度,递归,JavaScript,详细注释

Lee Chen

LeetCode 前端进阶训练营

震精,京东T8工程师每天熬夜到天明,竟只是为一套编程实战文档

周老师

Java 编程 程序员 架构 面试

从联想ThinkStation工作站,窥见工具文明的新纪元

脑极体

“海外同步优惠”与“中国专享折扣”十大必败榜抢先放送

爱极客侠

手把手教你AspNetCore WebApi:Serilog(日志)

AI代笔

ASP.NET Core web api serilog

MySQL事务隔离级别

长沙造纸农

MySQL 事务隔离级别 mysql事务 事务 MySQL 运维

架构师训练营第 1 期 - 第四周学习总结

Anyou Liu

架构师训练营第 1 期

架构师训练营第四章 系统架构总结

郎哲158

做好分库分表其实很难之二

架构师修行之路

微服务 分库分表

用NOSql给高并发系统加速

架构师修行之路

nosql redis 分布式 微服务

产品分析

时间是一个人最好的证明

产品经理 产品设计

对不起,学会这些 Linux 知识后,我有点飘

cxuan

Linux 后端 操作系统 计算机

讲一讲我所认为的「人生三最」,你或许能够参悟到什么

非著名程序员

程序员 个人成长 时间管理 精力管理

Spring Cloud 微服务实践(7) - 日志

xiaoboey

kafka 微服务 Spring Cloud 日志 spring cloud stream

架构师作业第三周学习总结

Wee权

古北水镇的夜

张晓楠

生活 摄影

LeetCode题解:111. 二叉树的最小深度,递归,JavaScript,详细注释

Lee Chen

前端进阶训练营

内存条的讲解

亚兰—硅的传奇official

原创 内存 硬件 计算机 哔哩哔哩

架构师训练营第1期第四周作业二

道长

架构师训练营第 1 期

记一次MySQL日期范围查询优化

墨凡

MySQL SQL优化

Apache Doris在云真信智能决策分析平台的应用实践

DorisDB

数据库 数据仓库 金融科技

建筑行业区块链应用场景是怎样的

CECBC区块链专委会

区块链 建筑行业

架构师训练营第三周作业

Wee权

关于国际化语言 Intl

西贝

JavaScript 前端 国际化 格式化

典型的大型互联网应用系统的技术方案和手段

APIs.guru加入了越来越多的API索引-InfoQ