草庐IT

使用eolink优雅地进行API接口管理

java李杨勇 2023-05-20 原文

为什么使用eolink?

我们都知道在一个项目团队中是由很多角色组成的，例如：业务>产品>设计>前端>后端>测试等。每个角色各司其职，一起合作完成项目的生命周期。而前端与后端的沟通则是主要通过接口来实现，通过接口文档事先约定好后端的接口返回内容，现在一般都是通用的JSON格式，然后大家就按照这个约定完成前后端的开发。并且一般接口文档都是通过后端人员编写的，但以前维护接口文档也是个麻烦事。随着现在敏捷观念的不断普及，大家发现传统的API管理只侧重管理API文档是不行的，存在以下明显的问题：

  1. 文档编写不规范：缺乏统一文档格式，简写、漏写或不写详细说明。
  2. 储存平台不统一：每个项目团队都有自己的使用习惯，平台很难统一导致无法高效维护和协作。
  3. 文档更新不及时：一般开发人员习惯于先开发后写文档。
  4. 变更历史不记录：由于没有及时维护文档，当需要回头检查项目会发现看文档不如看代码。
  5. 无法快速编写测试用例：传统API文档仅仅是个文档，测试人员需要使用其他工具编写测试用例。
  6. 沟通成本：由于上述原因，前端、后端、测试、运维等成员经常由于不清晰的文档而引发争论，有时候反而增加了沟通成本。
    为了解决上述问题，开始思考如何将开发与测试结合，比如通过代码注解生成API文档来减少后端开发编写文档的负担、可以基于API文档直接进行测试等。这个时代最突出的产品是 Swagger、Postman、Jmeter、SoupUI 等产品。
    但是上述产品的设计基本是基于本地开发和仅为小型团队使用，因此当遇到越来越高的迭代速度和质量要求时便显得力不从心，也会出现一些问题，比如：前端开发进度受制于后端、无法及时了解API变动、接口测试不方便、工作成果无法分享、测试工作被动等。

为了解决上述问题，Eolink推出新一代的 API 研发管理产品，帮助研发、测试及项目管理团队更好地完成 API 管理工作。目前Eolink结合了 API 设计、自动化测试、文档管理、监控、研发管理和团队协作的一站式 API 生产平台，还集成 Jenkins、Gitlab、钉钉、企业微信、飞书等平台，简直就是一个六边形战士，没有短板！而且它的页面是中文版本的，看起来比较亲切，很干净。

下载与安装

下载与安装地址：https://www.eolink.com/
支持多种操作系统，根据自己的需求选择适合自己的使用方式，下载后直接运行exe程序，一键安装即可，我自己用的是windows64位版本的客户端。

安装好之后需要进行注册或登录，这里我用的是微信号进行快捷登录。

创建API 项目

在 EolinK管理平台中，所有的 API 都是以项目的方式进行管理维护，首先需要创建一个 API 管理项目。点击添加按钮添加项目，输入项目名称、项目类型以及备注信息，点击确认完成添加。

新建立的项目在根目录，可以查看项目的名称，类型以及更新日期等，还可以对项目进行编辑，移动，复制，归档和删除操作，在删除的时候项目内数据数据都会被删除，而且无法恢复，这块需要大家谨慎操作。

同时也提供了一键导入功能，我自己将以前用postman测试的接口文档从postman导出为json格式，在Eolink里面选择导入项目即可，

不仅支持postman，同时也可以快速将Swagger、RAP、YAPI等产品内的数据快速迁移到Eolink中。

创建API文档

创建API项目之后，接下来就需要在Eolink中创建API接口文档，创建方式非常简单，在项目下新建点击添加API即可。

创建好 API 文档之后，可以在 API研发管理平台 中看到清晰的 API 文档信息，并且可以在此基础上进行测试API、编写API测试用例、编写Mock API、管理API版本等等的操作。
新建一个API接口：主要接口信息包括接口URL，接口基础信息，请求参数等，需要注意的是，此处只维护接口信息，类似于接口文档，不运行接口，运行接口的话需要点击保存后再进行发送测试请求。

API接口测试

当创建好 API 项目文档之后，可以立刻对该 API项目进行测试，目前Eolink平台支持本地测试、局域网测试、在测试发起是使用全局变量、增加额外请求参数、改变请求地址，也可以直接在界面编辑JSON、XML请求数据、同时也支持在测试过程中编写代码进行签名、加解密、生成随机数据等操作；这些特性都提升了用户体验和接口测试的效率。

如果路径或者参数配置出错，会提示对应的错误信息。

API 文档变更时自动通知

随着项目接口版本的迭代开发，当项目接口信息有所变化的时候，旧文档已经不能满足接口的要求，可以通过对相应接口文档的接口操作，根据现有接口信息进行重新录入，快速保存为接口的新文档。Eolink管理平台提供了变更通知功能，当 API 发生变化时通过邮件和站内信自动通知相关成员，并且显示变更的内容信息。

在Eolink管理平台中，可以将状态划分为以下阶段，方便项目组成员在查看项目 API 文档时了解接口当前所处的状态。

项目组不同成员操作状态时机也不相同：
比如产品经理：可以将接口状态设置为“已发布，设计中，待确定”
后端研发：可以将接口状态设置为“待确定，开发，对接，异常、维护、废弃”
前端研发：可以将接口状态设置为“测试，异常”
测试人员：可以将接口状态设置为“完成，异常，维护”

API文档标注

可以直接在 API 文档上发布评论，所有的沟通内容都会跟随 API 文档保留下来并且按照版本分类好

查看、回滚、对比API编辑历史
最后Eolink管理平台中还提供了版本管理功能，可以随时恢复历史记录。

可以具体查看对比两个版本之间的差异。

以上步骤就是完成一个简单的api接口测试操作。

Eolink下载地址

介绍了Eolink这么多实用的功能，用上了才是真福利！ 我也只是使用了一些基本的功能，应该还有很多功能，大家也可以再去发现和体验。

体验地址：https://www.eolink.com/

雅地eolinkxff0cxff0xffpostman压力测试单元测试接口测试

有关使用eolink优雅地进行API接口管理的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri，根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

    我有一个Ruby程序，它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重，我想提高压缩级别，因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗？是否有另一个允许指定压缩级别的Ruby库？ 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

  3. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法？ - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  4. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇，就使用ruby​​onrails自动化单元测试而言，你们正在做什么？您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您？git中的预提交Hook？只是手动调用？我完全理解测试，但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的，并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您？ 最佳答案 不确定您到底想听什么，但是有几个级别的自动代码库控制:在处理某项功能时，您可以使用类似autotest的内容获得关于哪些有效，哪些无效的即时反馈。要确保您的提

  5. ruby - 在 Ruby 中使用匿名模块 - 2

    假设我做了一个模块如下:m=Module.newdoclassCendend三个问题:除了对m的引用之外，还有什么方法可以访问C和m中的其他内容？我可以在创建匿名模块后为其命名吗(就像我输入“module...”一样)？如何在使用完匿名模块后将其删除，使其定义的常量不再存在？ 最佳答案 三个答案:是的，使用ObjectSpace.此代码使c引用你的类(class)C不引用m:c=nilObjectSpace.each_object{|obj|c=objif(Class===objandobj.name=~/::C$/)}当然这取决于

  6. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

    我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封，在我看来soap请求没有正确的命名空间。任何人都可以建议我

  7. ruby - i18n Assets 管理/翻译 UI - 2

    我正在使用i18n从头开始​​构建一个多语言网络应用程序，虽然我自己可以处理一大堆yml文件，但我说的语言(非常)有限，最终我想寻求外部帮助帮助。我想知道这里是否有人在使用UI插件/gem(与django上的django-rosetta不同)来处理多个翻译器，其中一些翻译器不愿意或无法处理存储库中的100多个文件，处理语言数据。谢谢&问候，安德拉斯(如果您已经在ruby​​onrails-talk上遇到了这个问题，我们深表歉意) 最佳答案 有一个rails3branchofthetolkgem在github上。您可以通过在Gemfi

  8. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声？ - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点？我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等)，但我确实想创建一个输出文件。

  9. ruby-on-rails - 按天对 Mongoid 对象进行分组 - 2

    在控制台中反复尝试之后，我想到了这种方法，可以按发生日期对类似activerecord的(Mongoid)对象进行分组。我不确定这是完成此任务的最佳方法，但它确实有效。有没有人有更好的建议，或者这是一个很好的方法？#eventsisanarrayofactiverecord-likeobjectsthatincludeatimeattributeevents.map{|event|#converteventsarrayintoanarrayofhasheswiththedayofthemonthandtheevent{:number=>event.time.day,:event=>ev

  10. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

    我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗？当我运行compasswatch时，它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行？文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们？我自己编译的.sass文件编译成compiled/t

随机推荐