Hitchhiker 是一款开源的 Restful Api 集成测试工具,你可以在轻松部署到本地,和你的 team 成员一起管理 Api。
先上图看看:
背景是 Team 在开发一些 Api,这些 Api 依赖于其他 Team 的 Api,依赖的 Api 是比较底层且比较大的,用起来不太方便且没有详细文档。
在开发 Api 的过程中有一个问题让我比较在意,我们 Team 是我先研究那个依赖的 Api,过程不太容易,需要找文档,找那个 Team 的人协作,找 case 等,研究了一些后做了一些东西,后面隔了一段时间开始陆续有其他同事参与进来,每进来一个都去研究一下那个 Api,包括我做了其他事情后再回来开发 Api 时又得找资料熟悉下,这个过程造成了很大程度的时间和经验的浪费。
所以我觉得应该有款工具能让 Team 的人一起协作开发 Api,和 Code 一样,每个人研究的东西可以保存下来方便其他开发,这就是开发 Hitchhiker 的第一个引子。
后来,Api 开始发布出去,为减少 QA 的工作量,需要做一个 Api 的自动化测试工具来保证数据准确性,希望能让测试环境的数据和生产上的数据作对比,这样保证新开发的 Api 不影响到旧的,测试专注于新功能就好,这是第二个引子。
Api 的性能也是个关键的指标,在大规模使用前也需要对 Api 的性能做测试,所以性能测试是 Hitchhiker 下一个目标。
如果 Api 是公开的话,文档是必须的,试想如果我们依赖的 Api 文档好的话不仅我们这边容易,他们那边其实也省事不少,至少我们不用去频繁打扰他们了。不过写文档过程是比较痛苦的且更新很麻烦,但如果 Api 的 case 都已经有了的话,文档的主体其实就有了,然后对参数加些说明就可以了,QA 熟悉的话都可以帮着做,所以一个所见即所得并且支持模板的文档也在计划中。
其实我们之前也是有用过一些测试工具,但不是很满意,就易用性来说,最好用的还是 Postman,所以 Hitchhiker 的 UI 就是模仿它的,用过 Postman 的话会很容易上手。
Team 协作开发 Api
Api 历史修改记录及支持 diff 展示
支持多环境变量及运行时变量
支持 Schedule 及批量 run
不同环境下的请求数据对比 (eg: stage vs product)
易部署 (支持 docker, windows, linux), 数据都存在自己这里,不会上传及丢失
会记往任何修改,不用怕没保存时 session 失效或系统重启
支持导入 Postman v1 collections
性能测试 (开发中...)
Api 文档 (计划中...)
首推使用 docker 部署,简单快捷,具体操作参考 deploy with docker
如果没有 docker 环境也可以使用源码部署,也很简单
linux 请参考 deploy to linux
windows 请参考 deploy to win
参考 使用说明
前后端分离,前端采用 React + Redux + AntDesign,后端基于 Nodejs, 采用 Koajs + TypeORM + MySQL。
语言统一用的 Typescript。
测试的话,前端用 Jest,覆盖了逻辑最多的 reducer,后端使用的就是本工具来测试自己,这对时间有限的我来说算是最有性价比的选择。
可以访问 http://hitchhiker-api.com/ 来使用,点击 try without login
免注册登录,另外,为了免备案,服务器在海外的,所以速度上可能会有点慢,抽疯时甚至可能访问不了,请谅解。
当然最好还是在本地局域网部署,用起来会比较爽。
Github: https://github.com/brookshi/Hitchhiker, 觉得不错的话麻烦 Star 支持下,谢谢。
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.