随着信息化飞速增长的还有各信息系统中的应用接口( API ),API 作为信息系统内部及不同信息系统之间进行数据传输的渠道,其数量随着软件系统的不断庞大而呈指数型增长,如何管理这些 API 已经在业界变得越来越重要,需要将 API 开发的敏捷性、速度和效率提升到了全新的水平。
API管理
很多人认为,API 的管理无非是对 API 信息的管理,只要将 API 记录在 Word 或 Wiki 文档就足够了,这其实是一种想当然的想法。根据实际经验,这些文档随着时间的推移,缺少维护,而逐渐变成了最初工作的凭证而已,已和实际运行的 API 大相径庭了,已失去了其作为 API 文档的意义了。
在目前成功的API管理实践中,API 管理应该至少包括以下内容:
1)API 文档信息管理
2)API 测试质量管理
3)API 研发流程管理
4)API 自动测试管理
只有至少实现了以上四点,才能称之为有效的API管理,API才能更有效地服务于企业,把 API 的开发提高到新的水平。
API管理现状
现有应用系统大多采用前后分离端架构或微服务架构,一般规模的系统至少有上百个 API,对于庞大的系统,包含数千个 API 是很正常的,并且系统内的 API 不仅数量众多,并且种类各异,分布在不同的地方。目前 API 管理主要存在以下难点:
1)API信息管理困难
由于系统中拥有纷繁复杂的 API,在研发过程中因疏漏无法及时更新API信息的情况时有发生,最后会导致 API 信息出现缺漏。对于 API 的开发者和使用者来说,API 文档信息逐渐失去参考价值;对于项目管理者来说,API 信息无法与测试、项目迭代进度等内容关联起来,无法了解项目的实际研发、测试和运行情况。
2)API 研发协作困难
在 API 管理平台不统一的情况下,每个项目团队都有自己的使用习惯或历史遗留问题,平台不统一导致无法维护和协作。并且由于API变更时没有及时更新文档和通知到相关人员,导致项目检查、后期测试、前后端对接过程中高昂的沟通成本,拖后项目的进展。
3)API 测试困难
测试人员需要看着接口文档再另外使用工具进行测试,另外接口发生了变化,需要重新再写测试用例,增加了工作量降低了效率。测试总是排在最后进行,无法参与项目讨论,无法快速大范围回归测试,甚至无法按时完成测试任务,导致项目延期或者忐忑上线。
4)API 自动化测试困难
测试人员需要学习编程语言去编写测试脚本,但是测试脚本因更新不及时、编码风格不完善、不方便协作等原因导致使用成本较高,测试报告也不够清晰。
5)API 测试管理困难
测试团队以及项目管理人员无法准确了解测试效果,无法通过数据来量化当前项目质量。项目管理人员缺乏一个平台来展示团队开发进度,如完成需求量情况,是否通过测试、对接和发布等信息。
Eolink的解决之道
Eolink 提出针对 API 开发协作的创新理念——文档与测试驱动开发(DTDD),何为文档与测试驱动开发呢?简而言之:
1)用标准文档代替口头约定和笔记文档,让开发、测试、运维、协作有迹可循;
2)快速用测试结果推动开发进度,让团队沟通更充分、管理有事实依据,实现敏捷开发。
依据这个理念,Eolink 提供一套先进的解决方案,目标是降低研发过程中因为API管理导致的效率低下、测试不清、管理困难等问题,通过敏捷的API研发管理方案和理念来推动企业业务的快速发展。下图所示为 Eolink 解决方案示意图:

Eolink 的实战
1. API 信息管理
全面的 API 信息管理模块,通过手动 或自动方式生成 API 信息,全面记录和展示 API 信息。
1)设计 API:能够详细、规范地记录API的所有信息,可以通过它来设计、统一 API 的开发规范(如下图所示)。除了手动创建 API 外,还可以从其他工具或系统导入已经设计好的接口,如 Postman、Swagger、Jmeter、Apifox、YApi 等。

2)管理 API:API 信息里面会记录创建人、负责人、最后修改时间等信息,并且可以为 API 定义 Tags,对 API 进行分类,可以更好地对 API 进行管理,如下图所示:

除此之外,还可以绑定 Github、Gitlab、码云等代码仓库,可以一键自动生成 API 文档,也兼容 Swagger 代码注解生成 API 文档。
2.API测试管理
一键发起测试,拥有专门的测试编辑器可以直接编写 JSON、XML 数据,还可以支持自动生成测试数据,能够通过 Javascript 代码对请求参数、放回结果进行二次加工,实现复杂场景的测试。

系统会记录每一次请求的历史,可以看到详细的测试时间、请求及返回信息等,这样保证了测试结果可查并且可追溯。

3.API 自动化测试
Eolink 实现了零代码实现 API 自动化测试,能够让测试人员通过界面就可以完成自动化测试,并且提供了 Javascript 脚本模式,可以通过非常简单的脚本来编写复杂的 API 测试用例,实现自动化测试中复杂的流程跳转、数据加解密、验签等目的。

4.API研发管理
通过把产品系统的各个研发周期串联起来,可实现产品、开发、测试、运维等各个环节和人员的综合协作。通过Mock API可以实现前后端同时开发,通过API状态统计,可以快速了解到当前项目内所以API的状态分布;除此之外,还可以制定迭代计划并跟踪开发进度,将API绑定到迭代计划上,可以帮助团队将开发进度精确到以API为单位,实现更精确的进度跟踪。

除此之外,还可将API设置为已发布、设计中、待确定、开发、对接、测试、完成、异常、维护发、废弃等状态,可根据每种状态设置状态变更操作,如当API变为测试状态时测试人员,当然,状态发生改变或改变接口本身时,也可以手工选择需要通知的人员。如下图所示,当更新接口状态时,不仅需要更新相关变更信息,而且还可以选择是否触发变更通知。

总结
以上展示只是 Eolink 强大API管理功能中的极小一部分,除了API管理外,Eolink 还提供了自动化测试服务、API 网关、API 监控、API 自动生成等服务。Eolink 是国内 API 管理解决方案的领军者,是国内最大的在线 API 管理服务供应商,服务了包括泰康在线、苏州银行、太平洋证券、阳光保险集团、联通支付等众多机构。
通过对 Eolink 试用,深以为其不愧为精心打造的 API 管理利剑,如果您有需要或感兴趣,可以在其提供SaaS版本上免费使用!
图中所使用的的接口管理工具是 eolink,感兴趣可以自行使用:www.eolink.com
我正在使用i18n从头开始构建一个多语言网络应用程序,虽然我自己可以处理一大堆yml文件,但我说的语言(非常)有限,最终我想寻求外部帮助帮助。我想知道这里是否有人在使用UI插件/gem(与django上的django-rosetta不同)来处理多个翻译器,其中一些翻译器不愿意或无法处理存储库中的100多个文件,处理语言数据。谢谢&问候,安德拉斯(如果您已经在rubyonrails-talk上遇到了这个问题,我们深表歉意) 最佳答案 有一个rails3branchofthetolkgem在github上。您可以通过在Gemfi
我有用于控制用户任务的Rails5API项目,我有以下错误,但并非总是针对相同的Controller和路由。ActionController::RoutingError:uninitializedconstantApi::V1::ApiController我向您描述了一些我的项目,以更详细地解释错误。应用结构路线scopemodule:'api'donamespace:v1do#=>Loginroutesscopemodule:'login'domatch'login',to:'sessions#login',as:'login',via::postend#=>Teamroutessc
我安装了ruby版本管理器,并将RVM安装的ruby实现设置为默认值,这样'哪个ruby'显示'~/.rvm/ruby-1.8.6-p383/bin/ruby'但是当我在emacs中打开inf-ruby缓冲区时,它使用安装在/usr/bin中的ruby。有没有办法让emacs像shell一样尊重ruby的路径?谢谢! 最佳答案 我创建了一个emacs扩展来将rvm集成到emacs中。如果您有兴趣,可以在这里获取:http://github.com/senny/rvm.el
是否有简单的方法来更改默认ISO格式(yyyy-mm-dd)的ActiveAdmin日期过滤器显示格式? 最佳答案 您可以像这样为日期选择器提供额外的选项,而不是覆盖js:=f.input:my_date,as::datepicker,datepicker_options:{dateFormat:"mm/dd/yy"} 关于ruby-on-rails-事件管理员日期过滤器日期格式自定义,我们在StackOverflow上找到一个类似的问题: https://s
在应用开发中,有时候我们需要获取系统的设备信息,用于数据上报和行为分析。那在鸿蒙系统中,我们应该怎么去获取设备的系统信息呢,比如说获取手机的系统版本号、手机的制造商、手机型号等数据。1、获取方式这里分为两种情况,一种是设备信息的获取,一种是系统信息的获取。1.1、获取设备信息获取设备信息,鸿蒙的SDK包为我们提供了DeviceInfo类,通过该类的一些静态方法,可以获取设备信息,DeviceInfo类的包路径为:ohos.system.DeviceInfo.具体的方法如下:ModifierandTypeMethodDescriptionstatic StringgetAbiList()Obt
我正在使用Mandrill的RubyAPIGem并使用以下简单的测试模板:testastic按照Heroku指南中的示例,我有以下Ruby代码:require'mandrill'm=Mandrill::API.newrendered=m.templates.render'test-template',[{:header=>'someheadertext',:main_section=>'Themaincontentblock',:footer=>'asdf'}]mail(:to=>"JaysonLane",:subject=>"TestEmail")do|format|format.h
我正在尝试使用Ruby2.0.0和Rails4.0.0提供的API从imgur中提取图像。我已尝试按照Ruby2.0.0文档中列出的各种方式构建http请求,但均无济于事。代码如下:require'net/http'require'net/https'defimgurheaders={"Authorization"=>"Client-ID"+my_client_id}path="/3/gallery/image/#{img_id}.json"uri=URI("https://api.imgur.com"+path)request,data=Net::HTTP::Get.new(path
Rails相对较新。我正在尝试调用一个API,它应该向我返回一个唯一的URL。我的应用程序中捆绑了HTTParty。我已经创建了一个UniqueNumberController,并且我已经阅读了几个HTTParty指南,直到我想要什么,但也许我只是有点迷路,真的不知道该怎么做。基本上,我需要做的就是调用API,获取它返回的URL,然后将该URL插入到用户的数据库中。谁能给我指出正确的方向或与我分享一些代码? 最佳答案 假设API为JSON格式并返回如下数据:{"url":"http://example.com/unique-url"
关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我的公司有一个巨大的数据库,该数据库接收来自多个来源的(许多)事件,用于监控和报告目的。到目前为止,数据中的每个新仪表板或图形都是一个新的Rails应用程序,在巨大的数据库中有额外的表,并且可以完全访问数据库内容。最近,有一个想法让外部(不是我们公司,而是姊妹公司)客户访问我们的数据,并且决定我们应该公开一个只读的RESTfulAPI来查询我们的数据。我的观点是-我们是否也应该为我们的自己
我想用这两种语言中的任何一种(最好是ruby)制作一个窗口管理器。老实说,除了我需要加载某种X模块外,我不知道从哪里开始。因此,如果有人有线索,如果您能指出正确的方向,那就太好了。谢谢 最佳答案 XCB,X的下一代API使用XML格式定义X协议(protocol),并使用脚本生成特定语言绑定(bind)。它在概念上与SWIG类似,只是它描述的不是CAPI,而是X协议(protocol)。目前,C和Python存在绑定(bind)。理论上,Ruby端口只是编写一个从XML协议(protocol)定义语言到Ruby的翻译器的问题。生