「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

API 小达人
• 阅读 252

程序员最讨厌的两件事:

  1. 写文档
  2. 别人不写文档

写文档、维护文档比较麻烦,而且费时,还会经常出现 API 更新了,但文档还是旧的,各种同步不一致的情况,从而耽搁彼此的时间,大多数开发人员不愿意写 API 文档。

Eolink Apikit 为后端工程师提供 API 文档的创建与自动化生成、快速接口调试、以及 API 文档版本管理功能,协助后端工程师快速编写文档,调试接口,以及支持版本控制恢复历史记录。

通过一套系统、一份数据,解决多个系统之间的数据同步问题。只要定义好接口文档,接口调试、数据 Mock、接口测试就可以直接使用,无需再次定义。接口文档和接口开发调试使用同一个工具,接口调试完成后即可保证和接口文档定义完全一致。高效、及时、准确!


1、创建 API 文档

  1. 点击“+ 添加API”按钮后,系统会新开一个新建API的标签。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

  1. 在新页面中填写API文档的信息,居然可输入信息如下。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

  1. 点击左上角的保存按钮即可创建新的API文档。

2、自动化生成 API 文档

该功能可通过配置数据源信息,实现基于数据源的API信息自动生成API文档。当前支持5种数据源:Swagger URL、apiDoc、Github、gitlab、码云。

  1. 点击“+ 添加来源”后,系统弹窗中可选择5种数据源,可选择其中一种。(此处以推荐的“通过 Swagger URL”来举例)

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

  1. 选中来源类型后,根据提醒填入来源名称和对应的swagger.json访问地址即可。注意该访问地址需要允许外网访问方可使用。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?


3、快速接口调试

1. 已有 API 文档快速测试

如果该接口已经在Apikit上创建了文档,则可以直接在文档内选择测试子TAB,进行快速测试。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

2. 未有文档临时测试

如果未创建该接口文档,仅临时调试接口,则可创建API快速测试页面。可在这个页面输入接口相关的信息并进行快速测试。

若测试没问题,可点击右上角的“保存为新API”,快速把测试数据保存为API文档,方便下次调试。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?


4、API 文档版本管理

API文档的版本管理有两类,单API文档的编辑历史记录,以及项目级API文档的版本管理。

1. API 文档历史记录

点击API文档详情页右侧工具栏中的“历史记录”图标按钮,即可查看该文档的所有历史编辑记录。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

在历史记录列表中,可对该文档过往的历史记录进行对比、查看备注、以及恢复该历史记录的内容。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

2. 项目级版本管理

Eolink Apikit 提供项目级的版本管理功能,可以对项目进行打版本,保存一份当前项目所有API文档的快照。以便进行版本对比和分支版本管理。

点击“+ 添加版本”按钮,并输入版本号后点击确认,系统会对当前项目创建新的版本快照。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

可随时查看某个版本的所有API文档信息,并可对多个版本进行版本对比。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?

支持把某个版本直接复制成新项目进行分支版本管理,或把历史版本数据进行全局导出。

「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?


无论使用什么语言开发,Eolink Apikit 都可以统一规范地管理起来,并提供强大的文档管理、协作、测试、分享功能。

  • 自动生成 API 文档,并支持动态更新;
  • 首创的版本管理、差异对比、变更通知;
  • 强大的自定义请求校验与响应,便于前后端对接和集成测试等场景;
  • 在线分享 & 导出,版本管理与评论,方便开发协;
  • 支持多层级项目权限管理,支持自定义角色与权限。
点赞
收藏
评论区
推荐文章
liam liam
2年前
5分钟打造好用好看API文档
5分钟打造好用好看API文档🤔️你是否遇到过这样的场景?对接第三方开放平台文档的时候,左手刷着接口文档看API,右手操作着接口调试工具🧱写完接口想交付或提供API文档给第三方使用,又觉得文档展示体验一般?很鸡肋?
liam liam
2年前
先写API文档还是先写代码?
代码未动,文档先行其实大家都知道API文档先行的重要性,但是在实践过程中往往会遇到很多困难。程序员最讨厌的两件事:1.写文档,2.别人不写文档。大多数开发人员不愿意写API文档的原因是写文档短期收益远低于付出的成本,然而并不是所有人都能够坚持做有长期收益的事情的。作为一个前后端分离模式开发的团队,我们经常会看到这样的场景:前端开发和后端开发在一起
liam liam
2年前
程序员的摸鱼加速器!
最近趁摸鱼时间体验了一款神器,堪称后端前端们的摸鱼加速器,测试们的寿命催化剂。那就是:Apifox。中国自主研发的集文档、接口调试、Mock、接口自动化测试一体的协作平台。一套系统、一份数据,可解决多个系统之间的数据同步问题。定义好接口文档,则接口调试、数据Mock、接口测试就可以直接使用,无需再次定义;接口文档和接口开发调试也可以同一个工具,接口调试完成后
liam liam
2年前
满足你对 Api 的所有幻想
一、Api管理的难点在哪?相信无论是前端,还是后端的测试和开发人员,都遇到过这样的困难。不同工具之间数据一致性非常困难、低效。多个系统之间数据不一致,导致协作低效、频繁出问题,开发测试人员痛苦不堪。1.开发人员在Swagger定义好文档后,接口调试的时候还需要去Postman再定义一遍。2.前端开发Mock数据的时候又要去mo
API 小达人 API 小达人
9个月前
Eolink Apikit 快速发起 API 测试,一键生成测试数据
我们在测试接口时,通常需要先创建API文档,再根据API文档生成测试用例。未创建该接口文档,仅临时调试接口,EolinkApikit支持创建API快速测试页面,输入接口相关的信息即可进行快速测试。EolinkApikit支持操作数据库,API测试时,可以一键生成测试请求数据。这可以减少数据输入步骤,提高调试接口效率。
liam liam
2年前
为什么越来越多的开发者放弃使用Postman,而选择Apifox
一、API调试常用解决方案1、PostmanSwaggerMockJMeter作为一个后端开发,我做的大部分项目一般都是基于Swagger来管理API文档,基于Postman来做接口调试,基于JMeter来做接口性能测试,基于RAP等工具MockAPI数据。\2、存在的问题(1)多系统数据不互通API设计者、前
API 小达人 API 小达人
8个月前
国投证券如何引领金融行业的 API 治理创新?
在开发、对接阶段,因为API资产统一托管在平台上,因此可以通过API文档快速生成MockAPI,前端开发人员只需要通过MockAPI就可以快速对接后端接口,将前后端开发工作解耦,提高工作效率。在测试阶段,测试人员可以基于API文档快速创建单元测试用例,API文档和测试用例之间自动形成绑定关系。当API发生变更的时候,平台可以将数据同步到测试用例,并且可以与CI/CD流程结合,实现单元测试用例的自动化回归测试工作,并且将测试报告推送给相应邮箱。
API 小达人 API 小达人
1年前
【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口
对于开发同学来说,无论是新增还是修改接口文档,都需要在开发工具和接口管理工具上同步最新的数据。而且接口文档变更内容会比较琐碎和频繁。那么是否有更轻便的同步接口数据方式呢?我们提供了一个高效方案:在开发工具上基于接口代码片段,一键生成API文档,支持在开发工具中调试,并可一键上传至EolinkApikit的代码仓库中。这样不仅可以减少界面的操作和系统间的切换,还可以在开发工具上完成琐碎和频繁的接口文档更新,是当前CODETOAPI的最佳实践。
API 小达人 API 小达人
11个月前
【前端小技巧】如何使用 Eolink Apilkit 调用 Mock
在开发过程中,进度比较赶的情况下,前端人员当页面写完时,后台的接口还没写完,等要交付的时候后端才把接口给你,这个时候就很尴尬。这个时候Mock就可以很好的解决这个问题,前端团队可以在API还没开发完成的情况下,借助MockAPI实现预对接,加速开发进程。测试团队可以通过MockAPI解决不必要的系统,完成集成测试。EolinkApikit为前端工程师提供API文档管理,快速接口测试,以及MockAPI创建与调用,及查看文档变更历史的能力。有助于前端工程师快速查看API文档详情与历史记录,快速生成和使用MockAPI提前进行页面效果验证。
API 小达人 API 小达人
11个月前
如何进行自动化测试,提高测试效率?
作为测试人员,在进行比较大的项目时,使用自动化测试能帮助我们事半功倍地完成测试工作,提高测试效率,缩短开发周期。EolinkApikit为测试工程师提供API文档管理、快速接口调试、测试用例管理、及自动化测试等功能。协作测试工程师快速查看API文档及变更,以及更快的进行接口测试和自动化测试工作,降低测试用例编辑成本,提升自动化测试效率。