做技术管理的童鞋,往往会陷入这样一种困境:疲于奔命,到处救火填坑,沟通推进,却挤不出时间思考对团队和项目来说真正重要的事情。
你有没有经历过这样的场景: 1. 下属老是改了接口但不维护文档,屡说不改; 2. 后端改了接口没有及时通知前端和测试,导致下游环节的同事来投诉; 3. 由于团队每个角色使用的工具不同,工具之间的数据又无法兼容互通,导致一些共用的数据,每个人却要自己重复去创建、复制一遍;而一旦出现修改,每个人又要到不同软件再改一遍; 4. 新同事入职,工具入门门槛高,导致上手困难且缓慢
如果在你的项目组里,这样的状况反复发生,那么有必要考虑一下这个团队研发效能工具了——Eolink Apikit
Apikit 是结合 API 设计、文档管理、自动化测试、监控、研发管理和团队协作的一站式 API 生产平台,从个人开发者到跨国企业用户,Apikit 帮助全球超过50万开发者和10万家企业更快、更好且更安全地开发和使用 API。
一、既是单兵作战工具,又是团队协作神器
它的确做得很好。是单兵作战和团队协作都做得非常出色那种。
1.1 在单兵作战上
如果你是后端,那么Eolink Apikit 的可视化接口设计
和接口、文档一体化
功能比 swagger 更容易上手和维护;
它还能操作数据库
,支持30多种编程语言
, 调用外部函数和脚本
,支持持续集成
,调试功能比 Postman 更完备;
如果你是前端,那么 Apikit 的智能mock引擎
可用于一键 mock 出真实业务数据;
如果你是测试,那么 Apikit 的用例自动生成
可以让你高效执行自动化测试;
1.2 在团队协作上
如果你在一个团队里,那么整个团队只需要使用 Apikit 一个工具,一个项目只需要一套接口数据, 就能实现接口开发--接口文档管理--接口调试--接口自动化测试--接口维护--版本迭代
等一整个 API 研发流程和 API 从设计到上线的生命周期管理。
二、后端角色:文档管理、接口测试
2.1 可视化接口设计
和 swagger 需要通过编写代码形成接口页面不同,Apikit只需要填写请求参数、请求方法,响应参数、添加接口说明就能生成一份接口文档。
接口可直接进入调试环节,或者直接生成业务代码,同时也可进入下一环节,给前端调试页面,测试执行接口测试。
2.2 文档与接口一体化
接口和文档使用同一个工具,一旦接口有修改和迭代,文档可以同步更新维护,避免因为文档和接口分离造成维护不及时的情况。
体验链接:
https://www.eolink.com/?utm_source=cpcs&utm_content=cpy15
三、前端角色:智能Mock
3.1 最强 Mock API 能力
在瀑布流开发模式中,如果前端开发人员需要进行页面对接,需要后端先完成 API 的开发工作,因此前后端开发的进度会互相影响。通过 Mock API,您可以事先编写好 API 的数据生成规则,由 API 研发管理平台 动态生成 API 的返回数据。开发人员通过访问 Mock API 来获得页面所需要的数据,完成对接工作。
Eolink 提供市面最强的 Mock API 能力体系:
如果用户仅需要快速的基于接口文档中的返回结果获取对应的随机数据,则可以通过简易 Mock 功能获取对应信息。
如果用户期望通过一个 url 模拟不同的请求信息时,获取对应个的返回结果模拟数据,则推荐使用高级 Mock 功能。
3.2 高级Mock
高级 Mock API 支持根据不同的请求参数返回不同的 HTTP Status Code、Header、Body 等数据。您可以在一个 API 文档里创建多个高级 Mock API ,模拟前端发起的各种请求,方便对前端逻辑进行校验。当项目正式发布时,只需将高级 Mock API 的地址前缀替换为实际的访问地址即可。
3.3 简易Mock
简易 Mock 功能可在编写 API 文档的时候,同时对不同的返回结果进行 Mock 配置。并且可预置智能 Mock 规则,在编写返回参数时,若参数名和字段类型匹配智能 Mock 规则时,系统自动填入该参数的 Mock 规则。配置简易 Mock 后,API 文档会自动生成 Mock URL,用户可复制该 URL 直接调用得出想要的数据结果。
体验链接:
https://www.eolink.com/?utm_source=cpcs&utm_content=cpy15
四、测试角色:自动化测试
4.1 自动生成用例
在 Apikit 的自动化测试应用中,所有的测试用例都是以项目维度来进行管理,一个自动化测试项目可以从多个 API 文档项目中引用 API 信息来创建 API 测试用例。
进入用例管理页面,点击 添加用例 按钮,在弹窗中输入测试用例的名称,然后点击确定:
进入流程测试用例详情页,点击添加测试步骤,在下拉菜单中选择 从 API 文档新建 API 测试。
4.2 创建定时测试任务
API 自动化测试可以设置定时任务,实现项目在无人值守的情况下自动测试并且发送报告给相应的邮箱,监控项目监控情况。
主要功能有:
-
允许对测试任务进行分组,最大支持二级分组;
-
测试任务支持设置循环条件:永久、仅执行一次;
-
测试任务周期可为周、日,时间粒度为每小时;
-
可以从已有的用例中选择测试用例;
-
支持设置测试环境;
-
支持测试完成后通过邮件发送结果;
4.3 生成测试报告
进入测试报告页面,在这里会列出所有手动批量测试、定时测试、Open api 测试的测试报告。在定时测试报告列表,你可以在这里选择某次测试任务,依次点击查看详情 - 全部。在弹出的 HTML 页面可查看详细记录该次测试报告的所有信息。
用户查看测试报告详情时,可以编写测试总结。例如测试背景,测试目标以及测试结果分析。
测试报告支持下载和在线分享,以及邮件发送,邮件会将测报告概括内容自动带入到邮件正文中。用户收到邮件后,可以点击测试概括内容跳转到在线测试报告。
体验链接:
https://www.eolink.com/?utm_source=cpcs&utm_content=cpy15
五、团队协作:API全生命周期管理工作流
作为一个单兵作战的利器,它有优于传统工具的表现,但它能做的事情不止于此。实际上是,互联网发展了这么久,工具一直在推陈出新,但第一次,有一个工具彻底打通了从接口设计、文档管理、前端调试,接口自动化的整个接口研发流程;能够覆盖到从接口设计,到修改、维护、版本迭代的接口全周期的管理。开发和测试再也不用费劲巴拉地 —— 写接口文档用 swagger,接口调试用 postman,页面调试用 mock.js,测试用 Jmeter,一遍遍地导入甚至手动复制接口数据到这些工具中。
协作才是 Eolink Apikit 真正的杀手锏。项目接口数据零散分布在不同工具中,由不同人员掌握,往往造成迭代一时爽,沟通修罗场,维护火葬场。而使用 Eolink,一个工具,一份项目接口数据,团队每个角色参与其中,各取所需。
后端用它来做文档管理和接口设计, 前端用它来调试页面, 测试用它来做自动化,相同的参数字段只用写一次,其他人用到直接调用。相同的接口只需写一次,各端都能共享。相同的用例只需写一次,就能搭积木般构造出测试用例。因为不需要使用多个工具,也就减少了工具切换和数据导入等重复工作所浪费的时间;因为使用同一套数据源,一旦接口数据发生变更,数据能及时同步更新到各端,不需要另外告知、由下游环节的童鞋自己手动去修改。
5.1 旧项目轻松迁移
大家手头上必然还有一些经年的项目在维护,想要迁移到 Apikit 里也很简单,目前支持多达 20 种格式的接口数据导入,足以实现无缝导入,一键迁移。
5.2 丝滑的团队协作
在线分享 & 导出,版本管理与评论,让跨团队协作更流畅。可在线分享 API 文档或导出为离线文件,方便开发协作;对 API 信息进行版本管理,可任意切换、对比版本,了解改动内容;可对 API 文档发表评论,评论会按照版本进行归类;
分析统计报表,API 治理情况一览无余。针对 API 设置各类自定义标签,如 API 的开发状态、负责人等信息。系统会自动自动统计并生成报表,方便您随时了解项目状况;
支持多层级项目权限管理,支持自定义角色与权限可以根据部门、项目组对项目进行管理,单独设置某个项目的操作权限,并且可以自行定义每个角色的权限。满足企业合规和安全的需求;
5.3 免费使用
Eolink Apikit的免费版已经支持非常强大的功能,足够个人开发者和小团队管理和协作使用。如有进阶需求,可考虑购买付费版,当然性价比也很高。
总结
总的来说,Eolink Apikit非常强大,强大的文档管理,高级Mock API能力,自动化测试,高效的协作和完善的权限管理,强烈推荐大家使用。
体验链接:
https://www.eolink.com/?utm_source=cpcs&utm_content=cpy15