作为Java开发工程师,如何高效优雅地编写接口文档

举报
奔四码农 发表于 2021/08/11 17:51:10 2021/08/11
【摘要】 作为一名优秀的Java开发工程师,编写接口文档向来是一件很头疼的事情。本来就被bug纠缠的很累了,你还让我干这?其实,你可以试试ApiPost。

作为一名优秀的Java开发工程师,编写接口文档向来是一件很头疼的事情。本来就被bug纠缠的很累了,你还让我干这?

其实,你可以试试ApiPost。

ApiPost的定位是Postman+Swagger+Mock Server,主要用来发送调试接口和生成接口文档。如果你愿意,也可以用它生成Mock 数据,当Mock Server使用。

下面就简单介绍如何利用ApiPost调试接口和快速的生成接口文档,让您初步体验ApiPost的魅力!

1. API写完想要测试?试试模拟发送一次请求

新建接口,我想模拟发送请求如下

curl --location --request POST 'http://apis.juhe.cn/mobile/get?phone=13429667914&key=1950d2a44f1b4b9a671d6c53f3d5b6be'

如图进行进行配置:

点击发送,查看接口返回结果:

你可以查看返回数据,返回Header、Cookie、状态码、请求时长等等数据。

2. 测试完后我想快速生成文档给前端看

点击分享文档

复制并打开文档地址就可以看到了完整的接口文档。

3. 后记

恭喜你体验了第一个接口文档的旅程。我们的工具同时节省了前后端的开发以及沟通时间。

除此之外ApiPost还有更多更好的功能等您来体验。

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。