准备工作:
- POSTMAN Version 8.0.9客户端
- 一个可用的电子邮箱
- 如果本文图片不清晰,可以点击POSTMAN发布测试接口查看较清晰的版本
导出已有api数据(适用于已有api但未登录Postman)
- 点击设置
2. 点击data并导出
登录Postman
- 若无账号自行注册
- 点击登录,已有登录记录会保存在浏览器中
- 登录成功后,点击workspace;能看见操作的记录
发布接口
已有api文件使用上面导出的数据再重新导入,点击设置按钮,切换到data页签下,导入json文件
下面实际操作新建项目并补充接口信息并发布
-
创建项目文件夹集合,并补充描述信息
-
项目文件夹下创建功能文件夹,名为:模拟xx单据
-
在模拟xx单据文件夹下添加一个请求接口,依次补全接口名,接口参数注释,接口注释
-
请求接口,并点击保存,save as example
-
补全响应体注释信息并点击save保存
-
现在已经有一个接口的请求和响应,并且注释信息补充完整了;接下来发布接口文档
点击项目文件夹的view document按钮,会切换到整个项目文件夹的文档页面
能看见我们请求参数及描述都有了,响应体中的描述信息也有了
点击publish发布,发布过程中有一点慢,耐心等待。发布成功后,将地址分享给前端即可。