随着信息技术的发展,API 变得无处不在,无处不用。但令人费解的是,都 2203 年了,竟然还有很多人使用 word 调试 API?
今天,西红柿将带领大家打开新世界的大门,放下诺基亚,抄起智能机!!!
有些小伙伴可能不理解,什么是 API,详见:
不做开发的小伙伴可能感受不到,使用 Word 交流 API,首先需要 API 开发人员,编写 word 文档。受制于每个人的文档能力,编写习惯参差不齐,读者往往会非常痛苦。
随着 API 的不断修改迭代和调试,同一 API 的文档版本会越来越多,管理起来极其费劲,文档传递 one-by-one 口口相传,项目整体开发效率可想而知!
除此之外,传统的 API 管理,只是维护了一下 API 文档,用 word 文档或者 wiki 等把 API 简单描述。这种模式在互联网是的敏捷开发的背景下,难免会出现诸多问题:
如图所示,接口文档 无法跟开发和测试的环节联动,你开发你的,文档始终慢我一步。没有有效的 API 管理协作模式,不仅大大增加开发成本,甚至会影响项目进度。
但其实,这个尴尬的难题早就被攻克了。高级程序员早就使用工具管理 API 了,他的工作模式是这样的:
可以看到,接口文档 跟开发和测试的环节完美联动,有变化能第一时间通过,自动生成 api 文档获取到,同时,自动生成的专业化 api 接口文档,格式可读性更强,内容更加丰富详实。
这些 API 管理的困境,也让一些企业嗅到了商机,以 Eolink 为代表的公司,也在很早就开始布局,积极投入研发力量,经过大量实践探索,打造出了一款天花板级别的全生命周期管理的 api 工具!!
现在,放下诺基亚,抄起iPhone。我将为大家详细介绍,顺带附上官网体验链接:- API 管理工具:https://www.eolink.com/
全生命周期 8 大解决方案:
每一项细分功能如下:
Eolink API 研发管理平台是一个集 API 文档管理与快速测试于一体的 API 协作研发平台,属于 Eolink API 全生命周期管理产品生态中的重要基石。
Eolink API 研发管理平台基于 Eolink 提出的创新理念:文档与测试驱动开发(DTDD),规范管理和测试所有 API。联动前端、后端与测试人员,构建敏捷团队,统一管理 API 相关数据,帮助团队内部共享工作成果。并能通过与其他系统对接,强化 DevOps 能力。
通过 API Studo,可以方便快捷的设计 API 文档,
API 编辑页面中可以填写 API 文档、返回数据、额外说明等信息,您可以通过顶部的标签切换。
在 API 研发管理平台 中,您可以通过三种方式来创建 API 文档:
进入 API 文档详情页,点击上方 测试 标签,进入 API 测试页,系统会根据 API 文档自动生成测试界面并且填充测试数据。
测试用例支持对返回结果进行校验,以下是几种结果校验规则:
校验方式 | 描述 |
---|---|
不校验 | 无论返回结果是什么,均认为测试通过 |
校验状态码 | 判断响应头部中的 HTTP Status Code |
校验 JSON | 判断响应结果的 JSON 结构和参数值,可以判断对象、数组、字段等信息 |
校验 XML | 判断响应结果的 XML 结构和参数值,可以判断对象、数组、字段等信息 |
完全匹配 | 判断响应结果是否等于预期结果 |
正则匹配 | 通过正则表达式去匹配响应结果,如果匹配的结果集不为空,则认为测试通过 |
加强监控协作的第一步就是确保 API 的可见性和对项目的共享。我们可以使用 eolink 监控功能轻松实现。每个人都可以了解到所关注 API 的开发,修改,上线等情况。
设置当 API 删除或异常时,通知某位成员。
API 研发管理平台 提供了变更通知功能,当 API 发生变化时通过邮件和站内信自动通知相关成员,并且显示变更的内容。
无论使用什么语言开发,无论是 HTTPS、Websocket、TCP、UDP、HSF、gRPC、DUBBO 等协议,还是 Restful、SOAP、WebService 等规范,Eolink 都可以协助团队快速、统一、规范地管理起来。
Eolink 可以一键发起测试,支持自动生成测试数据,能够通过 Javascript 代码对请求报文、返回结果等进行加解密、签名等处理。一键发起,让繁琐的 API 测试变得简单顺滑。
当 API 发生变化时,可以一键进行 API 回归测试,系统会自动根据规则判断返回结果并得出测试报告,方便团队快速了解 API 改动的影响范围,可减少超过 95% 的测试时间!
Eolink 支持非常强大的动态 Mock API,可以根据不同的请求参数自动返回不同的 HTTP Status Code、Header、Body 等数据,并且支持在一个 API 文档里创建多个 Mock API 。
在测试需要 Cookie 的 API 时,Eolink 支持在 Cookie 管理里添加所需的 Cookie 信息,系统会自动存储 Cookie,下次测试其他相同域名的 API 时会自动传递 Cookie 请求参数。
使用API工具替代WORD的管理API的方式,除了在开发/测试/管理/迭代等方面的表现出强大优越性,还有许许多多让人眼前一亮的功能,等待你亲自尝试。
官网体验链接:点我体验 API 专业工具
不得不佩服 eolink 的开源格局,希望Eolink 越办越好,造福国内程序员。