【接口测试】接口文档神器swagger

点击上方蓝色“程序员一凡”，选择“设为星标”

主页点击“领取资料”获取整理好的学习资源

---

大家好，我是一凡，来自微信公众号程序员一凡。

今天给大家分享接口测试以及接口文档一个神器叫做swagger

大家在之前有没有听说过接口文档工具swagger，在公司有没有用过？如果有接触过的伙伴可以在评论区打下它的名字（swagger或者打一个1）没有用过的同学可以打一个0.这个是我们在企业中现在比较主流的接口文档工具。

我们今天来认识一下swagger！

Swagger介绍

Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务。Swagger让部署管理和使用功能强大的API变得非常简单。

Swagger是一种标准的规范，通过这套规范，你只需要按照它的规范去定义接口及接口相关的信息。再通过Swagger衍生出来的一系列项目和工具，就可以做到生成各种格式的接口文档，生成多种语言的客户端和服务端的代码，以及在线接口调试页面等等。这样，如果按照新的开发模式，在开发新版本或者迭代版本的时候，只需要更新Swagger描述文件，就可以自动生成接口文档和客户端服务端代码，做到调用端代码、服务端代码以及接口文档的一致性。

接口测试之前的准备

工具/框架

首先你要思考用什么来做接口测试，比如我们用什么工具去做接口测试，我们常用熟悉比较好基础入门的Postman，

当然大家也可以用其他的，比如Httprunner，这是最新的一个框架，那可能还有用Jmeter，你可能还用Python的Request库。

这些是你用来做接口测试的工具或者框架。

所以在做接口测试之前我要确定我用什么工具来做接口测试

接口需求文档：

肯定需要一个接口文档，虽然有很多同学说，听说过，如果没有接口文档我们就要去抓包，可能通过一个F12（打开浏览器开发者工具）里面可以抓取到一些接口的网络请求

比如说这里就可以抓取到一些网络请求

那一般的真正的你在公司做接口测试，你凭F12抓包是远远不够的。这个你可能在调试某一个功能，你想看它调的什么接口。（调试）如果你真正去做接口测试，必须要有一个接口文档，必须要有一个需求文档。不然你没法测试，除非专门有一个开发一直站你旁边，那也不大现实。所以你要熟悉需求文档。这些接口文档一般的公司都有，现在不管大小公司，就算是几个人的研发团队，他其实也是有接口文档的 ，只是说你做为一个测试，你可能不知道，或者开发没和你说。

比如说像这种类型

开发可能自己编写了一个什么页面，这里都是一些接口，这些接口的什么作用，什么类型，参数，开发都会写的清清楚楚。因为现在互联网架构，都是一个前后端分离（移动互联网主要架构），前端想要调用后端接口，那肯定也是依赖这个接口文档。

前端开发不可能依靠你和开发口语之间的表达去调用接口，肯定需要有这样的接口文档，只是说你作为一个测试可能不知道。

如果面试官问你：你之前通过什么做接口测试？

你说你通过抓包！通过F12。虽然你可以抓到接口，但是你说你用这个方式去做接口测试，是很不“专业”的，它只是抓取部分接口的方式。

接口需求文档，这个是必须存在的，你必须要去熟悉的

所以，如果要开展接口测试，如果没有接口文档，你就说做不了，就好像你做功能测试一样。

做功能可能还好一点，有产品会给你提供，它的业务它的交互，或者一些需求文档。

--》功能测试：产品提供原型图，交互，需求文档

--》接口测试：你让产品经理给你提供接口需求文档是不大可能的

今天分享的swagger，为什么要讲swagger，因为接口文档开发也有不同的写法，比如前面的接口文档图是开发自己去编写的，还有下图这个就是我们规范的swagger文档

现在在企业中，百分之七八十以上的公司，研发部都有自己像这样的swagger文档，你不信，你明天可以去问一下你们公司的开发，我们有这个swagger文档吗？肯定有，只是说他有可能没有告诉你。

一个系统就有非常多的接口，比如说一个模块，商品模块，订单模块，支付模块，和我们功能测试是不是一样的？每一个功能都它的接口。

想要更深入了解学习的伙伴可以观看视频，有本章的视频教程。

视频实战详解：https://www.bilibili.com/video/BV1Hp4y1s7FV

软件测试全栈六大模块：

01.功能测试基础

02.Python编程

03.自动化测试

04.持续集成

05.性能测试

06.测试开发

这些技术掌握后，在任何一线大厂软件测试部门，你都能够独当一面！哪一部分，怎么学，为什么要学这些东西，大家想了解的可以长按下方二维码备注（一凡）免费领取学习资源福利。

一凡（你若盛开，清风自来)

哔哩哔哩：
测试汪大牛（中高级教程）

软件测试萌新娜娜（软件测试基础）

不让测试人孤寂的成长，陪你成为优秀的测试工程师！

往期精彩内容

教程

Test

十分钟快速搭建Python+Selenium自动化测试环境
自动化框架之python+selenium+pytest
Python模块化以及内置模块的使用
手把手教你完整Python接口自动化测试----附源码

面试

Test

怎么做自我介绍最加分？

高级自动化测试5个重要面试题（含金量高，分水岭能pass掉很多人）初级软件测试工程师面试题软件测试面试真题解析
搜狗软件测试工程师笔试题（附答案）
求职季&毕业季|软件测试大厂面试技巧大公开！
面试官：软件测试没搞懂这些，哪里来的自信投简历？刁钻问得高频的面试题（含答案）
30页面试宝典文档资料，助你拿下百度、美团、字节跳动、小米等大厂的offer【内含答案】

职业规划：

软件测试工程师应该怎样规划自己?
软件测试怎么从功能测试转成自动化测试/开发？
10年软件测试工作总结
10年软件测试心路历程——愿测试人不再迷茫
关于软件测试Python自动化，你想知道的都在这了
软件测试7年之痒的工程师，讲述当初是怎么突破的瓶颈？少走弯路
从写下第1个脚本到年薪30W，我的自动化测试心路历程【资源共享】

本文分享自微信公众号 - 程序员一凡（gh_6cafb826630a）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一起分享。

来源：oschina

链接：https://my.oschina.net/u/4512374/blog/4945118