CTO,开发人员:如何评估外部API的质量?

现在,为了改善您的服务,找到一个外部API变得越来越容易。越来越多的公司提供API。问题是许多开发人员/ CTO立即启动API集成,而这应该是最后一步!在此之前,您需要确定此API的质量是否符合某些最低要求。我告诉你我是怎么做到的。我希望它能帮助其他CTO和开发人员。

数据质量

许多API公开数据以便您丰富您的系统(当然并非总是如此,例如,Stripe不是一个丰富API)。检查这些数据的质量至关重要。这将花费你很长时间,我知道你不喜欢测试!我也不是,但你不能避免在这里建立一个严肃的测试场景。如果您在完成API集成后仅2周就意识到数据质量不够好,请相信我,你会后悔...

文档

我最近遇到了一个暴露了大量数据的API(在我看来比他的竞争对手要好得多),但它的文档很糟糕!实际上它几乎不存在。除此之外,它并不总是尊重基本的REST标准。如果没有正确记录错误代码,您如何可能集成外部API?那么唯一的解决方案就是让你一次又一次地进行测试,以便了解引擎盖后面的工作原理。逆向工程可能很有趣,但需要花费很多时间。记住你没有Github回购在这里探索,因为源代码不可用...糟糕的文档是开发人员的大量时间损失,中期肯定会有惊喜。

图书馆

您可以使用您喜欢的语言使用特殊库来使用API??吗?作为Python和Go开发人员,我总是很高兴看到提供Python库的API(我知道我现在可以忘记Go)。它可以为您节省大量时间,但首先要确保lib足够成熟并涵盖所有API功能(并非总是如此)。

供应商的声誉

声誉可以帮助您了解将来是否会对您的API产生不良后果。通过坏的惊喜我的意思是服务中断,功能回归,甚至是服务的结束......你可以部分解决,通过问自己以下几个问题:

  • 这个API在互联网上很受欢迎(一般来说,如果你发现很少的信息,逃跑)?是否有很多文章/教程在谈论它?那些文章是正面的吗?
  • 是一些受欢迎的公司使用它?
  • 如果公司开发了libs,它们在Github上很受欢迎吗?Github上的问题是否经常解决?
  • 是否有API的最新更新或很久以前发布的最新更新?

技术支援

当您遇到问题并且答案相关时,请确保有人通过电子邮件快速回复您。如果您位于欧洲并且API由美国公司运营,请检查时差是否不是太大问题。

尊重标准

在我看来,您今天只选择RESTful API。如果您喜欢的API不遵守REST标准,那就要小心了。但请记住,REST标准的含义并不完全清楚,每个API都实现了自己的规则(HTTP代码,POST请求编码,......)。不过,仔细查看文档,并检查您是否看不到原始内容。创意将减慢你的速度......

价钱

当然价格非常重要。但要小心,API价格并不总是易于理解。您是否会因为无限量的请求而每月收费?按要求收费?如果是这样,您将被收取两次相同的请求(如果是浓缩API)或第二个请求是免费的吗?您是否会因没有返回结果的请求(HTTP 404)而被收费?确保您了解定价的所有含义。

服务质量(QoS)

QoS非常重要。基本上,您希望API快速运行并尽可能减少停机时间。不幸的是,这不是一个容易测试的问题。实际上,QoS可能会随着时间的推移而变化很多,并且许多API提供2级QoS,具体取决于您使用的是免费版API还是您付费的...有时您也可以选择具有不同响应时间级别的不同订阅。

并行查询支持

根据您计划集成API的方式,您可能希望通过对API进行多个并行查询而不是按顺序查询来加快速度。就个人而言,我大部分时间都在使用Golang。如果是这样,请小心:许多供应商不支持并行查询,当他们这样做时,他们总是设置限制。在这种情况下,请务必询问他们这个限制是什么(并不总是在文档中说明)并根据此调整脚本。

这篇文章对我来说将是一个很好的备忘录。

原文地址:https://www.cnblogs.com/apifind/p/11002237.html

时间: 2024-11-10 15:41:28

CTO,开发人员:如何评估外部API的质量?的相关文章

SWTBOK测试实践系列(2) --你会把开发人员提交测试的版本打回去吗?

开发人员奋斗了很多个夜晚,终于把版本提交测试了.他们可以松一口气了.但是噩耗很快传来,软件没有通过测试团队的预测试(为了保证测试进程,对开发人员提交的代码进行基本功能或业务流程的验证).开发经理老王,迅速找到负责预测试的测试经理老张. 老王说:老张啊,怎么回事?出什么问题了?我们好不容易开发完成了,你们怎么不测试还把版本打回来了? 老张说:你们提交的版本质量太差,没有我们的预测试,需要重新修改后,符合我们的要求,我们才能测试.你看看我们发现的这两个问题. 老王并没有看这两个问题,而是直接质疑老张

IPHONE6 近来1年不会开放NFC的API给开发人员,也就是仅仅能用来做支持了如今

IPHONE6 近来1还不会开放NFC的API给开发人员,也就是仅仅能用来做支持了如今,可是能够肯定的是,以后肯定会放发出来的.就像指纹传感器一样,如今也开放出来了.前面5S的时候,还也没有放出来,小伙伴们.峁足劲干吧.!! Apple to limit iPhone 6 NFC to Apple Pay, restrict developer access By AppleInsider Staff According to a report on Monday, Apple is restr

开发人员首选跨平台工具之最新调查

感谢几月几日的投递VisionMobile发布了一份新报告,报告中统计了开发人员当前使用的跨平台工具.未来计划要使用的跨平台工具以及打算弃用的跨平台工具.调查结果预示着行情不太稳定,许多开发人员都倾向选择寻找更好的工具. 市场分析和策略公司 VisionMobile 进行了一项调查,目的是从开发者角度对跨平台工具(cross-platform tools,CPT)进行评估.调查对象跨越了整个地球,共有来自 91 个国家超过 2400 名开发人员参与其中.VisionMobile 从一份超过 10

《转》适用于开发人员的10个最佳ASP.NET的CMS系统

1) mojoportal mojoPortal 是一个开源的.用 C# 编写的站点框架和内容管理系统,可以运行在 Windows 中的 ASP.NET 和 Linux/Mac OS X 中的 Mono 下. 当前的特性 遵循 XHTML 的内容管理 用 WebParts 个性化自己的页面 博客 论坛 事件日历(Event Calendar ) 图像画廊(Image Gallery ) 文件管理 基于数据库.Active Directory, OpenLDAP, Open ID, 或 Windo

拥抱新的.Net开发框架,WPF开发人员怎样向.Net迁移

ArcGIS Runtime 10.2版本号中.将WindowsPhone .WindowsStore以及WPF三大SDK整合成了一个全新的SDK--ArcGISRuntime SDK for Microsoft .Net Framework,简称.Net SDK.同一时候现有的WPF SDK能够继续使用.但兴许会停止更新.因此,Esri建议WPF开发人员们向.Net阵营迁移. 顾名思义,新的.NetSDK面向微软的.Net框架,曾经的WPF.Windows Phone以及Windows Sto

.NET CoreCLR开发人员指南(上)

1.为什么每一个CLR开发人员都需要读这篇文章 和所有的其他的大型代码库相比,CLR代码库有很多而且比较成熟的代码调试工具去检测BUG.对于程序员来说,理解这些规则和习惯写法非常的重要. 这篇文章让所有的CLR开发者都尽量能在较少知识的情况下,去了解CLR中自己工作的那一部分内容.这篇文章将会为你呈现CLR的发展史,以及不同阶段解决的不同问题和不同阶段解决问题以后给开发者带来的一些更加便利的东西. 1.1代码规范 这是最为重要的一个章节!设想一下本文的目录里面的一些项,然后想想自己该如何设计代码

推荐给开发人员的6个实用命令行工具

推荐给开发人员的6个实用命令行工具 作为一名Web开发者,当程序出现问题时日子总不是那么好过.问题可能无处不在,可能是你发送的请求出了错,可能是回复出了错,可能是你使用的某个第三方库出了问题,又或者是一个外部API调用失败了.优秀的工具对于定位问题出在何处有着无可估量的价值,而且能在一开始就帮助我们阻止问题的出现,总的来说能使我们的工作更有效率.命令行工具尤其有用,因为它们非常易于做自动化和脚本处理,能够以各种不同的方式进行组合和重用.本文介绍了6个非常强大且灵活的工具,熟练使用这些工具能使你的

SAP成都研究院35岁以上的开发人员都去哪儿了?

2006年成立的SAP成都研究院,位于天府软件园B区.如今,因为研究院发展的不断壮大, 已经搬迁到天府软件园E区了,因此,发生在图片building各种充满悲欢离合的故事,已经成为一部分小伙伴脑海中难以磨灭的回忆,永远消逝于历史的长河之中. 我为什么要写这篇文章 SAP成都研究院有很多刚从大学毕业不久的年轻小伙伴加入.一起聊天时,有小伙伴悄悄向我打听,"咱们公司的开发人员们咋看起来都是年轻人?35岁以上的开发人员去哪儿了?难道程序员真是吃青春饭的?" 这些同学想的比较远,值得赞一个,看

Expo大作战--针对已经开发过react native项目开发人员有针对性的介绍了expo,expo的局限性,开发时项目选型注意点等

简要:本系列文章讲会对expo进行全面的介绍,本人从2017年6月份接触expo依赖,对expo的研究断断续续,一路走来将近10个月,废话不多说,接下来你看到内容,讲全部来与官网 我猜去全部机翻+个人修改补充+demo测试的形式,对expo进行一次大补血!欢迎加入expo兴趣学习交流群:597732981 [之前我写过一些列关于expo和rn入门配置的东i西,大家可以点击这里查看:从零学习rn开发] 相关文章: Expo大作战--什么是expo,如何安装expo clinet和xde,xde如何