BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

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

| 作者 Benjamin Young 关注 1 他的粉丝 ,译者 薛梦迪 关注 0 他的粉丝 发布于 2016年6月17日. 估计阅读时间: 3 分钟 | 如何结合区块链技术,帮助企业降本增效?让我们深度了解几个成功的案例。

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

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

APIs.guru正在进入一个持续拥挤的市场,其中还有别的API索引网站,包括The API StackAPI CommonsAPIs.ioAnyAPI和更老的索引例如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说明定义就会从提交的格式(RAMLAPI BlueprintWADL等)被转化到OpenAPI 2.0的格式。最后,一个日常脚本会运行,来监控源API定义的更新。

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


感谢张龙对本文的审校。

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

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT