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作为键:[:]。每个API描述的内容都包含:描述是什么时候加入的,现在推荐使用的API版本是什么,以及它的服务在OpenAPI文档中的链接(之前它以Swagger的名字为人熟知)。还有一个相对自由的格式叫做info对象,其中包含了基本的标题和描述信息,连同x-*键存放不同API提供者的具体信息。
除API索引之外的东西可以通过一个添加API的页面获取到,其中在GitHub上的APIs-guru/api-models库中开放了一个问题。一旦添加,提及的API说明定义就会从提交的格式(RAML、API Blueprint、WADL等)被转化到OpenAPI 2.0的格式。最后,一个日常脚本会运行,来监控源API定义的更新。
本文转自d1net(转载)