0
点赞
收藏
分享

微信扫一扫

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

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

其实,你可以试试ApiPost。

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

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

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

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

curl --location --request POST 'https://echo.apipost.cn/get.php?c=Course&id=1000' \
--header 'User-Agent: Apipost client Runtime/+https://www.apipost.cn/' \
--header 'Content-Type: application/json' \
--data '{
"course_id":1
}'

如图进行进行配置:

作为PHP开发工程师,如何高效优雅地编写接口文档_返回结果

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

作为PHP开发工程师,如何高效优雅地编写接口文档_数据_02

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

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

点击分享文档

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

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

作为PHP开发工程师,如何高效优雅地编写接口文档_数据_04


3. 后记

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

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

Apipost官方链接:​​https://console.apipost.cn/register?utm_source=10009​​

版权声明:本文为 知乎 小码哥 的原创文章。
原文链接:​https://zhuanlan.zhihu.com/p/398736153​​
举报

相关推荐

0 条评论