解决方案:收集我对 API 发现的想法
优采云 发布时间: 2022-11-17 15:40解决方案:收集我对 API 发现的想法
我正在尝试将所有 API 发现体验加载到我的脑海中,以便进行一些即将到来的对话。因此,我坐下来总结了迄今为止的 API 发现研究,以帮助我重新记住发生了什么以及我们是如何走到这一步的。API 发现是 API 领域中我个人致力于帮助推动事情向前发展的少数几层之一,能够看到所有移动部分一起帮助我继续这样做。让我们回顾一下我对过去 15 年 API 发现演变的记忆,这样我就可以更连贯地与不同的人谈论所有这些。
可编程网站
Programmable Web 是第一个能够发现 API 的来源,到 2020 年,它仍然是您寻找 API 的地方。ProgrammableWeb 在过去十五年中没有太大变化,除了所有者和运营商以及网站外观和感觉。它仍然是您查找新 API 和现有 API 的地方,也是您在 Google 时查找 API 的地方。
我对为 ModerableWeb 写作有着美好的回忆,它 网站 对我来说仍然是一个重要的信息来源,但我很沮丧 PW 多年来没有以任何有趣的方式推进 API 发现对话。我只是认为这是一个错失的机会,并且在 API 领域反映了很多,我认为这阻碍了我们所有人。
混搭 -> Express API
在可编程 Web 之后,API 世界的下一个演变是 MASHAPE,现在称为 Rapid API。API市场诞生于API管理时代,提供基础管理功能和API发现服务。提供一组非常丰富的 API,您可以使用 Quick API Marketplace 搜索和加载这些 API。
Marshall 和 Fast API 无疑推动了 API 发现对话,但就像可编程 Web 一样,它就此止步。当谈到 SEO 游戏时,RapidAPI 肯定会与可编程网络竞争,但除了简单 API 市场的基础知识之外,RapidAPI 确实没有太多东西——这很好,但我一直在瞭望台向前移动。
美国联邦政府 Data.json 索引
接下来,我将绕道而行,但我保证它与 API 发现有关。2013 年,我进入奥巴马政府工作,致力于帮助联邦机构使用 API 发布其公共数据资产。我在退伍军人事务部工作,但也花时间与其他机构合作,按照总统的授权在 15 个执行机构的 网站 域的根目录中发布所谓的 data.json 文件 - 你仍然可以找到今天可用的 15 个文件。
我已经设置了一个工作区来提取所有 15 个 data.json 文件,我正在研究它们以查看已发布的内容,并查看我在 2013 年开始的工作的状态。作为这项工作的一部分,我学到了很多关于数据发现的知识以及在大型官僚机构中进行数据发现的实际情况,这是我在参观后带回家的东西,并开始将我想看到的应用到主流 API 发现中。
APIIs.json / APIs.yaml
离开华盛顿特区后不久,我与 Steve Wilmott 合作从 3Scale 创建了一种名为 API.json 的新 API 发现格式。与 data.json 文件一样,API.json 将为 API 提供一种发现格式,但我会改进以更好地适应我认为需要的格式,以帮助推进政府内外的 API 发现对话。提供一种索引单个 API、API 集合、工作流和其他我们发现 API 并使它们自动和手动工作所需的方法的方法。
我即将将该规范推入下一个版本,并将继续致力于规范的发展。我有超过 40K 个 API.json 文件,用于我确定拥有 API、正在使用 API 或怀疑拥有 API 的公司、组织、机构和政府机构。随着我继续扩展我抓取和发现 API 的方式,我将继续尝试遍历列表中的每个条目。
APIs.io
当我们推出 API.json 时,我们也推出了第一个 API 搜索引擎。我们希望实施 API 发现规范,以展示推动 API 提供商了解更多信息并开始发布规范作为其运营一部分的潜力。APIs.io 还开始轮询其索引的 API.json 文件的更新,并开始考虑如何搜索新文件。使其成为第一个 API 搜索引擎,允许您在搜索 API 的同时以自动方式查找更新和扩展目录。
遗憾的是,我知道 APIs.io 没有得到维护。人们仍在向它添加 API,但如果 网站 出现故障,我想没人能回家让它恢复运行。网站 在 Red Hat 收购 3Scale,然后 IBM 收购 Red Hat 的洗牌中迷失了方向。虽然 网站 不是 API 发现对话的活跃部分,但它仍然在塑造讨论中发挥作用。
接口规范
随着可编程 Web、RapidAPI 的发展以及 API.json 和 APIs.io 的引入,出现了各种有助于改进 API 生命周期的规范,这些都有助于使 API 更加有形并最终被发现。这些 API 规范中的每一个都使查找 API 变得更加容易,无论您是在 Web 上、通过 Github 还是在本地网络的某个地方查找它。
在 API 发现方面,API 规范提供了一个非常关键的构建块。这些机器可读的规范描述了 API 的表面区域,同时提供了标题、描述和其他有助于使 API 更容易被发现的元数据。将 API 规范组织到市场、目录或中心将是 API 发现对话中的下一个明确步骤。
炫耀
在 Smart Bear 将 Swag 作为 OpenAPI 放入 Linux Foundation 后,他们启动了 Swag Hub 以帮助 API 提供商发布他们的 OpenAPI,使它们可供发现。正如它所说,该平台提供了一个 swag 中心,现在是 OpenAPI。允许开发人员发布和搜索不同类型的 API,同时还能够在整个 API 生命周期中使用它们进行编辑和编排。
SwaggerHub 绝对是一个 API 发现解决方案,但它从一个非常不同的位置关注它。它更多地是关于编辑和设计 API,然后使它们在 API 生命周期的多个站点可用,包括发现。以领先的 API 规范为基础,但重点关注如何在整个 API 生命周期中使用它。
API大师
与 SwaggerHub 类似,API.guru 中出现了另一种更开源的方法,它也聚合了 Swagger 和 OpenAPI 定义,但作为一个 GitHub 存储库,在其上构建了一个简单的搜索 网站。为一些最著名的 API 提供丰富的 OpenAPI 定义目录。提供一个单一位置,您可以在其中下载或分叉 OpenAPI 以获取各种 API,使搜索变得非常简单。
我喜欢 API.guru 的方法。Github 上的 API Discovery 对我来说很有意义。GitHub 不仅仅是管理代码,还提供了丰富的功能,可以使用 OpenAPI 等规范来推广不同的 API。您可以分叉整个 API.guru OpenAPI 目录,使其成为一个非常便携且可分叉的 API 发现解决方案,您可以在任何地方运行。
邮递员网络
当所有这些其他事情发生时,Postman 发布了他们自己的 API 目录,称为 Postman API 网络。提供由 Postman 自己的 API 规范定义的不同 API 的列表,称为集合。Postman 用户可以将自己的采集发布到 API Network,消费者可以通过分类浏览 API,或者通过关键字搜索 API。
使用最新版本的 Postman 平台,您现在可以在发布工作区中找到由 OpenAPI、RAML 或 GraphQL 定义的 API,以及集合、监视器、模拟服务器和其他组件。想想 Github 存储库,但专为 API 设计。此外,还开发了对 Postman 网络的搜索,以更详细地了解公共 API 以及您在个人或团队工作区中私下使用的 API。
更多接口目录
然后,我们开始看到更多 API 目录和弹出目录。最终消失的不止这些,但这显示了已出现的 API 发现解决方案类型的一个很好的横截面——帮助我们所有人在我们的应用程序中找到我们需要的 API。
大多数 API 目录都会启动,然后在休眠或完全消失之前收到一波又一波的更新。我自己创建了几个目录,只有在它们过时时才删除它们。保持 API 目录的最新和最新是一项大量的工作,而且确实没有多少钱可以做——至少现在还没有。
有目的的 API 发现
最近,我们开始看到新一波 API 发现解决方案的出现,但这种解决方案不仅仅是寻找 API。它是关于寻找 API,以便您可以解决其他一些更紧迫的需求,例如安全性或合规性。这里有一些新颖的方法来寻找 API,帮助我们理解我们越来越依赖的非常抽象和无形的基础设施,这些基础设施在我们周围呈指数级增长。
您会明白为什么我们需要发现这里展示的整个 API 产品组合。我觉得仅仅搜索 API 不足以将 API 发现提升到一个新的水平。我们需要其他原因来发现我们周围出现的 API 基础设施。API 的增长速度通常如此之快,以至于我们跟不上文档和其他更传统的查看和发现 API 的方法。
只是谷歌它
事实上,大多数 API 都是通过简单的 Google 搜索发现的。我认为这将永远成为现实,我认为谷歌将继续投资帮助我们找到我们需要的 API。然而,这只会帮助我们找到我们正在寻找的公共 API。我们需要能够帮助我们找到我们的公共 API 以及我们所依赖的私有和合作伙伴 API 的解决方案,这些 API 无法通过 Google 搜索发现。
享受寻找新 API 的乐趣
事实上,定期引入新 API 的方法并不多。您可以通过阅读 tech crunch、调整到 Twitterverse 或 Reddit 的正确部分来学习新的,但我会说产品搜索。你也可以听听ProgramambleWeb,用新API的不断滴灌来引入新的API,但我最终还是希望有更多的方式来引入API,但这可能是最不可能变现的方式。
进一步的发现语义
本次讨论的另一层是一些机器可读的构建块,它们可以帮助我们更好地描述我们通过 API 提供的资源,从而推动如何通过 Google 和其他搜索引擎发现 API。有多种方法可以标记、添加元数据和提供更多详细信息,以帮助默认情况下使我们的 API 更容易被发现。
所有这些构建块的挑战在于,它们需要大量工作才能添加到我们的每个 API,而且 API 提供商不太可能抽出时间来这样做。因此,服务和工具提供商需要使用通用元素(例如 JSON-LD 和其他丰富的格式)标记内容和扩充 API 定义,以帮助我们了解我们提供的数字资源和功能。
车道工程 API 发现的巅峰之作
多年来,我曾多次尝试提供 API 发现解决方案,而 API.json 直到最近才开始再次向前发展。我有一些其他的解决方案来来去去,最近的演变是我构建的内部平台的一部分,我简称为 Laneworks。这项最新投资是关于 API 发现和在网络上寻找新的和有趣的 API 并投资它们以收录在目录中。
我将停用用于自动发现 API 的 Laneworks 方法的 v1,并且我正在重新设计它以在公共工作区中运行。我将我的几千个 OpenAPI 和生成的集合移动到几千个公共工作区。然后,我会将这种自动化重新设计到 Postman 集合中,这些集合作为监视器按计划运行,允许我按工作区发现、收获、解析、排序和组织以进行发现。当我拥有它时,它往往会发现很多有趣的 API,这些 API 可以很容易地编目,但对抛光和可用性的最后润色总是需要时间,这是我过去从未有过的——谁知道未来会怎样。
新的 API 发现工具
我把它放在最后是因为它是几周前才发生的,但它是 API 发现对话取得进展的一个非常有希望的迹象。它是一种新的开源发现解决方案,是我见过的最先进的开源方法,可帮助发现公共和私有 API。
我一直想知道为什么 Google 没有加入 API 发现游戏。他们拥有搜索市场,并且他们已经为他们的 API 堆栈提供了一个发现解决方案,但这种开源方法显示了更多的潜力。我仍然需要使用 Google API Registry 来了解它的作用,但我认为它非常重要,可以收录在这个 API 发现叙述中。
要问的重要问题
到目前为止,API 发现的最大挑战是需要解决很多方面的问题。这不仅仅是关于搜索或发现 API。这是关于被发现。这是关于你如何描述你所做的事情。这取决于你是谁以及你的动机是什么。我问了几个问题来帮助我理解 API 发现对话的多个维度,这样我就可以看到一切。
这些问题的答案将随时改变 API 发现的状态。还有许多其他事情需要考虑,但这些领域反映了我多年来看到的混淆 API 发现水域的常见方式。很难真正提供一个简单的解决方案或向人们解释它的全部内容。老实说,我需要定期检查发生了什么,并定期刷新,这样我才能理解一些东西。有时我觉得在 API 发现方面没有发生任何事情,但是一旦我像这样进行刷新,我就会意识到发生了多少事情——它只是渐进式的。
接口发现驱动程序
既然我已经把所有这些都记在脑子里了,我想想想是什么推动了 API 发现。我想了解为什么人们想要发现 API,为什么拥有 API 的人想要发现它们,以及是什么促成了这些搜索。我希望了解生命周期 API 发现中最需要的地方。通过这个 文章,这里是我正在考虑的不同元素,因为我试图了解我们在 2021 年的 API 发现方面所处的位置。
在写更多之前,我必须孵化这些元素。API 发现当然不仅仅是将 API 组织到目录中并提供搜索机制,但我仍然不确定 API 发现的下一个演变是什么。当我认为在过去十年中 API 发现没有发生任何事情时,我肯定感觉好多了——发生了很多事情。与往常一样,在 API 领域,诀窍始终是将所有内容放在一起并阅读茶叶以弄清楚发生了什么,并考虑 API 发布者和消费者的需求 - 这就是本博客 文章 的所有内容。
我总是怀疑我对 API 发现的看法。我是 API 的分析师、发布者和消费者。我也沉迷于 API。这让我在寻找 API 时完全不同。我认为普通的业务人员或技术人员并不关心 API——他们只是想在他们自己的世界里完成事情。我认为搜索是 API 发现的核心,但还有许多其他机制在起作用,这些机制将使该搜索与不同参与者的整体组合相关或不相关,这些参与者通常对为什么要查找 API 或找到他们的原因有相互竞争的动机应用程序接口。最后,我认为 API 发现的默认模式仍然只是“google it”。我不确定这是否更多地是关于网络搜索和发现而不是 API 发现,或者是否有更深层次的问题需要考虑。反正,
参考资料: apievangelist
解决方案:10款*敏*感*词*常用的SEO优化工具
优秀的SEO关键词排名工具会让你的SEO优化更有效,作为一个SEOer,你不仅要知道如何网站优化,还要知道如何使用SEO优化工具来加快网站优化的过程。今天, 推荐了十个实用网站SEO优化工具,希望对大家有所帮助。
1. 搜索引擎抓取内容模拟器
它可以模拟蜘蛛抓取特定网页,包括文本、链接、关键字和描述
2. 页面相似度检测工具
检查两页的相似度(如果相似度超过80%,可能会受到处罚)。
网站地图制作工具
1. 在线制作小网站地图文件
2. 使用工具制作中型网站地图
这是一个非常好的免费网站地图制作工具:站点地图*敏*感*词*
官方下载地址:
四、SEO优化辅助工具
中国切()。
5. 百度指数
显示注意和
指定关键词的媒体关注以图表的形式在百度中,登录后可以定义列表。
6. 关键词热门排名和指数
百度排行榜:
序曲关键词工具:
7. 网站站长工具
1. 搜索引擎优化站长工具:
2. 爱站工具:
3. 站长助手:
8. 网站流量统计工具
1. 百度统计:
2. CNZZ数据专家:
*它是每个网站随时监控自己网站流量的必备工具
9. 无效的链接检查工具
1、赛努链接侦探()
2、W3C 智能检查器()
10. 网站历史查询工具
互联网档案馆保存了自1996年以来使用Alexa搜索引擎获得的网站材料
以上就是 分享的十个SEO优化工具,都非常实用,可以加速你的网站SEO效果。