API界面功能布局
Header 参数
你可以设置或者导入 Header 参数,cookie也在Header进行设置
Query 参数
Query 支持构造URL参数,同时支持 RESTful 的 PATH 参数(如:id)
Body 参数
Body 提供三种类型 form-data / x-www-form-urlencoded / raw ,每种类型提供三种不同的UI界面
1)当你需要提交表单时,切换到 x-www-form-urlencoded
2)当你需要提交有文件的表单时,切换到 form-data
3)当您需要发送JSON对象或者其他对象时,切换到对应的raw类型即可
点击发送按钮后,如果有数据返回,则会显示返回数据,响应时间,响应码,Cookie等。
注意:返回数据默认是Pretty模式,便于查看 JSON XML 格式。您可以通过切换 原生 或 预览 模式 查看其它类型的类型。
复制并打开文档地址就可以看到了完整的接口文档。
本文主要是讲解一些需要注意的事项。
对于header、query以及form-data和urlencode的body参数,我们在如下地方填写参数描述:
如图中所示,对于一个填写过的参数,我们可以在新建接口可以通过点击参数描述后面的♦️方块标志快速导入描述,不用重复打字。
对于raw类型的body参数,我们可以通过点击“提取字段和描述”来针对参数进行描述的填写:
对于已经填写过的参数,APIPOST会自动匹配描述,不用重复填写。
很多新手困惑为什么APIPOST分享的文档没有成功响应示例和错误响应示例,那是因为APIPOST不会把发送后的实时响应的数据作为响应示例。
您需要手动的将实时响应结果导入或者复制到对应的成功响应示例和错误响应示例。
字段描述的填写跟raw类型的body参数,我们可以通过点击“提取字段和描述”来针对参数进行描述的填写。
同样,对于已经填写过的参数,APIPOST会自动匹配描述,不用重复填写。
作者:IT老哥
链接:https://juejin.cn/post/7022815674544160804
来源:稀土掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。