现在我们再次打开刚才我们创建的接口,来详细的给大家说明下如何去编辑一个接口
基本信息
当我们鼠标放在基本信息旁边的小图标上时会显示,该接口的编辑信息,如下图
这时我们再次打开刚才的接口会发现,基本信息一栏多出一个
“分享”栏,如下图所示:
分享:是不可编辑的,可复制该分享链接给别的同事,分享生成的页面如下图:
这里查看分享的信息如上图所示,可以查看该接口的详细信息!
快照信息
再往下看,我们会发现跟新建接口时相比,多了一个
快照信息,如下图所示:
在这里我们可以对我们的接口进行快照管理,当我们点击
“创建” 按钮时,会弹出如下窗口:
我们点击保存即可为此接口创建了一个接口快照信息!
下面我们在快照信息栏目,点击右侧的
“列表” 按钮,弹出如下窗口:
在这里我们可以看到我们创建过的接口快照列表,在这里我们我们可以对接口快照进行:
切换:切换快照状态
回滚:回滚快照状态
删除:删除当前选择的接口快照信息
参数
接口参数栏目,可根据自己的接口的参数进行填写,在DOClever新版中我们会发现,参数栏目右侧会有个

按钮,点击该按钮我们可以创建多个参数选项卡,具体如下图:
我们点击后会发现多出了一个参数切换项。我们可以对这些参数选项卡进行
编辑以及克隆操作!
对于很多接口,不同的入参会返回不同的出参,所以在DOClever里面,可以有多个入参出参的配对,每个配对可以称为一个参数实例。
上图中
“参数”就是一个参数实例,我们可以点击右边的加号来添加多个实例
Param: 当我们在路径里面填写含有restful形式的url时,比如我把我们之前的接口路径改为:/user/info/{id},DOClever会自动解析路径,并且提供对param参数的支持,如下图
Query: 这里代表的含义类似于http://aaa.com/user?name=sx&pass=111 这个地址中的name=sx&pass=111这样的参数,我们需要填入的是参数名称,参数是否必选,备注,参考值。点击未填值,弹出如下图所示:
填入该参数的参考值和备注,点击保存
Header: 这里的含义代表我们发送该请求的自定义http头部
Body: 当我们切换http method到post,put或者patch的时候,会出现Body这个标签页,我们切换到这个标签页,如下图:
这里分为两种模式,一种是以键值对形式(key-value),还有一种是把数据直接传给http body(raw),当Header里面的content-type为空或者为application/x-www-form-urlencoded,multipart/form-data的时候,DOClever会切换为key-value的形式,其他情况会切换为raw。
key-value:值得注意的是参数类型,可以有文本和文件两种,当选择文件的时候,DOClever会切换到multipart/form-data的方式发送数据。
raw:我们可以现在不同的数据类型,选择不同的类型header里面的content-type也会发生相应的变化,当现在JSON的时候,会出现如下图所示的界面:
JSON的具体操作会在出参里面做具体讲解
Inject: 这一部分在注入里面做详细讲解
Result: 这里代表的是出参的数据模型,出参也分为两种,JSON,RAW。
JSON:这里又分为Object和Array两种类型,Object代表返回的是一个json对象,Array代表返回的是一个json数组,参数字段从左到右依次为名称,类型,是否必有,备注,Mock或者参考值,删除按钮,新增按钮,这里值得注意的是类型,在DOCLever里面,json的类型有六种:String,Number,Boolean,Array,Object,Mixed,前五种都好理解,最后一种Mixed代表的是任意类型,当我们的参数类型不定的时候,就可以用Mixed来代替。当参数的类型为Array或者Object的时候,我们可以为该字段添加子字段,拖动该字段,我们还可以改变字段的顺序,或者父子关系。
RAW:如果返回的是其他类型的数据,就可以在RAW标签页里面填入相关的信息。