新闻资讯

新闻资讯 媒体报道

测试实战干货:怎么根据接口文档写接口?

编辑:016     时间:2021-07-27
一、为什么要有接口文档?

  没有接口文档的接口测试都是在抓瞎~前面的接口测试重点讲了协议,也讲了fiddler模拟接口请求,估计大部分还是不太懂怎么下手测试。这里小编专门拿出接口文档来做接口测试参考(估计很多测试小伙伴没见过接口文档)。

  举个栗子:前端开发和后端开发口头商量:“成功返回0,失败返回1”。结果最后开发出来,测试MM发现,后端成功返回1,失败返回0。于是两个开发开始撕逼大战,谁都不承认自己的错了。谁都不愿低头去认错,因为空口无凭啊,当初拍脑袋商量的事情,过两天就忘了。为了避免在这种小事上扯皮,浪费不必要的时间,于是就有了接口文档。

  白纸黑字写的清清楚楚,测试也有参考性。

  二、短信接口需求

  一切功能开发都离不开需求文档,一切测试也离不开需求文档

  工作方式

  · 双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。

  · 另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名和密码的方式。

  字符编码

  · 服务器接收数据可以是GBK编码字符,默认接收数据是GBK编码。

  · 请求响应返回内容是GBK编码。

  响应格式

  · 所为响应即每次向服务器提交请求后返回值

  · 响应值格式为纯文本状态码,例如发送成功后返回0

  三、发送短信接口文档

  功能:发送短信

  HTTP请求方式:GET/POST

  请求URL http://host:8080/sms/mt.jsp?cpName=用户账号&cpPwd=用户密码&phones=号码&msg=内容

  请求参数:



  返回结果:

  参数名称 类型 描述

  返回描述 String 发送成功返回0,如果发送不成功,则返回“ERROR&&对应的错误信息”

  请求示例

  GET http://host:8080/sms/mt.jsp?cpName=用户账号&cpPwd=用户密码&phones=号码&msg=内容

  (注:一般这种提交参数的接口用post方式,虽然get也可以提交,但是比较傻逼,要是遇到开发用get方式提交数据,可以抽他了。)

  四、批量发送短信接口文档

  功能:批量发送短信

  HTTP请求方式:POST

  请求URL

  http://221.122.112.136:8080/sms/batchmt.jsp?pack=数据包内容

  请求参数



  请求示例:

  POST http://host:8080/sms/batchmt.jsp

  请求数据

  {
  "cpid":"您的用户名


————————————————
版权声明:本文为CSDN博主「小马哥说测试」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/m0_60166861/article/details/119109378
郑重声明:本文版权归原作者所有,转载文章仅为传播更多信息之目的,如作者信息标记有误,请第一时间联系我们修改或删除,多谢。

回复列表

相关推荐