网站首页 > 博客文章 正文
一键生成文档
我们在“2分钟玩转APIPOST”一讲中,简单介绍了如何生成并分享接口文档:
点击分享文档
复制并打开文档地址就可以看到了完整的接口文档。
本节课主要是讲解一些需要注意的事项。
请求参数的描述填写
对于header、query以及form-data和urlencode的body参数,我们在如下地方填写参数描述:
如图中所示,对于一个填写过的参数,我们可以在新建接口可以通过点击参数描述后面的??方块标志快速导入描述,不用重复打字。
对于raw类型的body参数,我们可以通过点击“提取字段和描述”来针对参数进行描述的填写:
对于已经填写过的参数,APIPOST会自动匹配描述,不用重复填写。
响应参数的描述填写
很多新手困惑为什么APIPOST分享的文档没有成功响应示例和错误响应示例,那是因为APIPOST不会把发送后的实时响应的数据作为响应示例。
您需要手动的将实时响应结果导入或者复制到对应的成功响应示例和错误响应示例。
字段描述的填写跟raw类型的body参数,我们可以通过点击“提取字段和描述”来针对参数进行描述的填写。
同样,对于已经填写过的参数,APIPOST会自动匹配描述,不用重复填写。
猜你喜欢
- 2024-10-05 API 文档简洁之美,只需三步开启(api文档怎么写)
- 2024-10-05 自动接口文档生成实战教程(接口自动化上传文件)
- 2024-10-05 Postman与APIfox:两款强大的接口测试工具详解
- 2024-10-05 在线API文档工具Knife4j简明使用教程
- 2024-10-05 推荐四个强大的API管理平台(推荐四个强大的api管理平台是)
- 2024-10-05 接口文档生成详细教程(接口文档自动生成工具)
- 2024-10-05 TP5接口文档管理(tp5接口开发)
- 2024-10-05 推荐几款常见的API接口管理工具(api接口使用教程)
- 2024-10-05 一款零注解侵入的 API 文档生成工具,你用过吗?
- 2024-10-05 接口测试工具(接口测试工具swagger)
你 发表评论:
欢迎- 最近发表
- 标签列表
-
- ifneq (61)
- 字符串长度在线 (61)
- googlecloud (64)
- messagesource (56)
- promise.race (63)
- 2019cad序列号和密钥激活码 (62)
- window.performance (66)
- qt删除文件夹 (72)
- mysqlcaching_sha2_password (64)
- ubuntu升级gcc (58)
- nacos启动失败 (64)
- ssh-add (70)
- jwt漏洞 (58)
- macos14下载 (58)
- yarnnode (62)
- abstractqueuedsynchronizer (64)
- source~/.bashrc没有那个文件或目录 (65)
- springboot整合activiti工作流 (70)
- jmeter插件下载 (61)
- 抓包分析 (60)
- idea创建mavenweb项目 (65)
- vue回到顶部 (57)
- qcombobox样式表 (68)
- tomcatundertow (58)
- pastemac (61)
本文暂时没有评论,来添加一个吧(●'◡'●)