
事情是这样的:今天我们公司的后端说他接口写完了,并分享了一个接口文档给我,如图所示,整个文档就只是展示接口的各种参数和响应,比较单一。。。让我感觉没啥安全感。。

所以我按照了他分享的文档里的参数与响应数据,写到了我的前端页面上,由于时间比较紧急,前端这边简单自测了一下就匆匆上线了。。但是。。上线完当晚就炸了。。页面上各种接口报错:
参数不存在 参数类型错误 接口不存在(是因为接口写错了) 老板马上过来找我两,但是前后端开发人员各执一词:
前端:我吊你,怎么你分享的接口文档这么多错误? 后端:我吊你,你为什么没有测一测接口正不正常? 前端:我为什么要测?你为什么不能确保你接口的正确性? 后端:你为什么不测?你要是稍微测一下接口,能有这么多事?

这时候老板很冷静,阻止了我们的吵架,并分析了此次事故的主要原因:
1、后端马虎了,一些接口没有写对,也忘记调试了
2、时间紧,前端没来得及完全测接口
其实解决方法很简单:你们现在使用的在线接口文档,功能几乎为零,应该选择一个功能更加强大的在线接口文档工具才行。
这个工具应该具备以下功能:
调试功能,有利于前端调试
代码生成功能,这样前端可以少写点代码,提高效率同时也提高了准确性
接口同步功能,接口文档一定要是最新的代码信息
最后老板给我们推荐了Apifox这款工具,不得不说:姜还是老的辣啊~

Apifox = Postman + Swagger + Mock + JMeter。集接口文档工具、接口Mock工具、接口自动化测试工具、接口调试工具于一体,提升 10 倍研发效率。Apifox提供了帮助文档地址(原文链接中)

老板给我们推荐了它的一项功能——
首先进入公司的项目中,并点击左侧的在线分享

记得选择环境哦,你也可以设置密码,这里我就不设了~

可以选多个环境的哦~

接着复制一下链接,就可以打开在线文档喽~

接着在网页中打开本项目的在线接口文档

其实有时候后端也比较忙,所以有的前端在使用接口前,想自己动手调试一下,这样比较稳。不得不说,Apifox的在线文档真的惊艳到了我,居然可以在接口文档上调试接口~
首先点击右上角的运行按钮,会出现接口调试的模块

接着点击发送,即可运行接口,也可选择某个环境去运行

我心想,如果当时上线之前,用的是Apifox的话,那简直是不会出现事故:
参数不存在?我在线调试后获得数据了,通过比对我知道哪个参数不存在 参数类型错误?同样的,在线调试之后,通过比对,我知道哪个参数的类型是错的 接口不存在(是因为接口写错了)?调试的时候就报接口不存在了,第一时间找后端~ 在线文档居然能生成代码? 除了上面的调试功能,我发现Apifox在线文档的一个超级实用的功能——自动生成代码
点击对应的语言,可以生成请求的代码,只能说牛逼~当我选择了JavaScript之后,居然还为我提供了Fetch、Axios、Jquery等请求方式的代码,点击右上角复制代码按钮,即可复制代码

鼠标悬浮到返回响应的模块上,点击右上角生成代码

接着,你可以在弹窗的左侧选择你生成代码的配置,包括:编程语言、命名风格、校验开启等等
我突然觉得,我自己写的TypeScript代码还没它自动生成写的好哈哈,所以我都是直接复制过来的,简直是开发人员的福音啊~

如果分享者修改了接口信息,那么在线文档也会跟着更新,保持最新的接口信息~比如我这个接口的参数,由status改为type,并保存

我们可以看看在线文档这边,刷新一下,会发现,参数名也跟着更新了!!!

我还发现了Apifox的一块宝地——APIHub,在这上面,我发现了好多著名互联网公司的接口开放文档

牛逼~Apifox把这些公司的接口文档都分享给我们了

如果你喜欢某个项目,还可以把它克隆到你自己的团队中哦让我们玩一玩这些大公司的接口吧,顺便还能学学人家的接口时怎么写的哈哈😄

大家在选工具的时候,一定要选择能提高开发效率的工具~
反例:功能单一,不推荐!!!❌❌❌❌

推荐!!!Apifox多功能在线文档!!!✅✅✅✅


GivenIamadumbprogrammerandIamusingrspecandIamusingsporkandIwanttodebug...mmm...let'ssaaay,aspecforPhone.那么,我应该把“require'ruby-debug'”行放在哪里,以便在phone_spec.rb的特定点停止处理?(我所要求的只是一个大而粗的箭头,即使是一个有挑战性的程序员也能看到:-3)我已经尝试了很多位置,除非我没有正确测试它们,否则会发生一些奇怪的事情:在spec_helper.rb中的以下位置:require'rubygems'require'spork'
使用Ruby1.9.2运行IDE提示说需要gemruby-debug-base19x并提供安装它。但是,在尝试安装它时会显示消息Failedtoinstallgems.Followinggemswerenotinstalled:C:/ProgramFiles(x86)/JetBrains/RubyMine3.2.4/rb/gems/ruby-debug-base19x-0.11.30.pre2.gem:Errorinstallingruby-debug-base19x-0.11.30.pre2.gem:The'linecache19'nativegemrequiresinstall
我有:When/^(?:|I)follow"([^"]*)"(?:within"([^"]*)")?$/do|link,selector|with_scope(selector)doclick_link(link)endend我打电话的地方:Background:GivenIamanexistingadminuserWhenIfollow"CLIENTS"我的HTML是这样的:CLIENTS我一直收到这个错误:.F-.F--U-----U(::)failedsteps(::)nolinkwithtitle,idortext'CLIENTS'found(Capybara::Element
matlab打开matlab,用最简单的imread方法读取一个图像clcclearimg_h=imread('hua.jpg');返回一个数组(矩阵),往往是a*b*cunit8类型解释一下这个三维数组的意思,行数、数和层数,unit8:指数据类型,无符号八位整形,可理解为0~2^8的数三个层数分别代表RGB三个通道图像rgb最常用的是24-位实现方法,即RGB每个通道有256色阶(2^8)。基于这样的24-位RGB模型的色彩空间可以表现256×256×256≈1670万色当imshow传入了一个二维数组,它将以灰度方式绘制;可以把图像拆分为rgb三层,可以以灰度的方式观察它figure(1
1.postman介绍Postman一款非常流行的API调试工具。其实,开发人员用的更多。因为测试人员做接口测试会有更多选择,例如Jmeter、soapUI等。不过,对于开发过程中去调试接口,Postman确实足够的简单方便,而且功能强大。2.下载安装官网地址:https://www.postman.com/下载完成后双击安装吧,安装过程极其简单,无需任何操作3.使用教程这里以百度为例,工具使用简单,填写URL地址即可发送请求,在下方查看响应结果和响应状态码常用方法都有支持请求方法:getpostputdeleteGet、Post、Put与Delete的作用get:请求方法一般是用于数据查询,
Ruby是否有逐步调试器,类似于Perl的“perl-d”? 最佳答案 ruby-debug(对于ruby1.8),debugger(对于ruby1.9),byebug(对于ruby2.0)以及trepanning系列都有一个-x或--trace选项。在调试器内部,命令setlinetrace将打开或关闭线路跟踪。这是themanualforruby-debug原来的答案已经修改,因为数据噪声文章的链接,唉,不再有效了。还添加了ruby-debug的后继者 关于ruby-Ruby
给定一个nxmbool数组:[[true,true,false],[false,true,true],[false,true,true]]有什么简单的方法可以返回“该列中有多少个true?”结果应该是[1,3,2] 最佳答案 使用转置得到一个数组,其中每个子数组代表一列,然后将每一列映射到其中的true数:arr.transpose.map{|subarr|subarr.count(true)}这是一个带有inject的版本,应该在1.8.6上运行,没有任何依赖:arr.transpose.map{|subarr|subarr.in
我最近与一位同事讨论了以下Ruby语法:value=ifa==0"foo"elsifa>42"bar"else"fizz"end我个人并没有看到太多这种逻辑,但我的同事指出,这实际上是一种相当普遍的Rubyism。我试着用谷歌搜索这个主题,但没有找到任何文章、页面或SO问题来讨论它,这让我相信这可能是一种非常实际的技术。然而,另一位同事发现语法令人困惑,而是将上面的逻辑写成这样:ifa==0value="foo"elsifa>42value="bar"elsevalue="fizz"end缺点是value=的重复声明和隐式elsenil的丢失,如果我们想使用它的话。这也感觉它与Ruby
Ruby有一些不错的文档生成器,例如Yard、rDoc,甚至Glyph。问题是Sphinx可以做网站、PDF、epub、LaTex等。它在重组文本中完成所有这些事情。在Ruby世界中有替代方案吗?也许是程序的组合?如果我也能使用Markdown就更好了。 最佳答案 自1.0版以来,Sphinx有了“域”的概念,它是从Python和/或C以外的语言标记代码实体(如方法调用、对象、函数等)的方法。有一个rubydomain,所以你可以只使用Sphinx本身。您唯一会缺少的(我认为)是Sphinx使用autodoc从源代码自动创建文档
我怀念ipython的一件事是它有一个?为特定功能挖掘文档的运算符。我知道ruby有一个类似的命令行工具,但是我在irb中调用它非常不方便。ruby/irb有类似的东西吗? 最佳答案 Pry是IPython的Ruby版本,它支持?命令来查找有关方法的文档,但语法略有不同:pry(main)>?File.dirnameFrom:file.cinRubyCore(CMethod):Numberoflines:6visibility:publicsignature:dirname()Returnsallcomponentsofthef