接口文档生成工具 一键生成文档 ApiPost
16lz
2021-08-19
一键生成文档
我们在“2分钟玩转APIPOST”一讲中,简单介绍了如何生成并分享接口文档:
点击分享文档
复制并打开文档地址就可以看到了完整的接口文档。
本节课主要是讲解一些需要注意的事项。
请求参数的描述填写
对于header、query以及form-data和urlencode的body参数,我们在如下地方填写参数描述:
如图中所示,对于一个填写过的参数,我们可以在新建接口可以通过点击参数描述后面的♦️方块标志快速导入描述,不用重复打字。
对于raw类型的body参数,我们可以通过点击“提取字段和描述”来针对参数进行描述的填写:
对于已经填写过的参数,APIPOST会自动匹配描述,不用重复填写。
响应参数的描述填写
很多新手困惑为什么APIPOST分享的文档没有成功响应示例和错误响应示例,那是因为APIPOST不会把发送后的实时响应的数据作为响应示例。
您需要手动的将实时响应结果导入或者复制到对应的成功响应示例和错误响应示例。
字段描述的填写跟raw类型的body参数,我们可以通过点击“提取字段和描述”来针对参数进行描述的填写。
同样,对于已经填写过的参数,APIPOST会自动匹配描述,不用重复填写。
更多相关文章
- 关于PHP的回调函数
- 快递100参数错误-面单类错误(电子面单/发货单/模板)常见问题和解
- 08-04作业 : 函数的参数,闭包 ,全局作用域
- 函数的返回值和参数,匿名函数和变量的作用域
- PHP函数的返回值与参数,匿名函数与变量作用域的总结与实例
- PHP函数的返回值、参数及变量、函数作用域的总结
- PHP返回值&参数&变量作用域
- 函数的参数、返回值、作用域
- 0804-1. 总结函数的返回值,参数? 2. 匿名函数以及变量作用域问题