python接口自动化21-规范的API接口文档示例
时间:2022-05-07
本文章向大家介绍python接口自动化21-规范的API接口文档示例,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。
前言
接口文档到底长啥样?做接口测试最大的障碍在于没有接口文档,很多公司不注重接口文档的编写,导致测试小伙伴没见过接口文档。
运气好一点的测试小伙伴可能厚着脸皮找开发要过接口文档,然而拿过来的接口文档不规范,也是看的一脸懵,那么规范的接口文档到底是啥样的呢?
一、接口名称:
QQ号码测凶吉
二、接口描述:
接口地址:http://japi.juhe.cn/qqevaluate/qq
返回格式:json
请求方式:get post
请求示例:http://japi.juhe.cn/qqevaluate/qq?key=您申请的appKey&qq=283340479
接口备注:根据传入的参数qq号码和您申请的appKey测试qq的吉凶
三、请求参数说明(入参):
名称 必填 类型 说明
key 是 string 您申请的appKey
qq 是 string 需要测试的QQ号码
四、 返回参数说明(出参):
名称 类型 说明
error_code int 返回状态码
reason string 返回原因
result string 返回实体内容
conclusion string QQ号码测试结论
analysis string 结论分析
五、 JSON返回示例:
{
"error_code": 0,//返回状态码
"reason": "success",//返回原因
"result": {//返回实体内容
"data": {
"conclusion": "[大吉+官运+财运+才艺]如龙得云,青云直上,智谋奋进,才略奏功",//QQ号码测试结论
"analysis": "欲望难足希望高,计谋成功财力豪,猜疑嫉妒性自改,如龙乘云势运开。智能超人贯彻大志,富贵无比,不甘寂寞,叱吒风云之大吉数,但容易发生牢骚
及贪心、欲望太多而永不知足,为其缺点。切忌沉迷投机,可免贻误前程。"//结论分析
}
}
}
六、错误码参考:
七、Python代码请求示例:
Appkey参数需要注册申请,才能调用,原接口地址:[https://www.juhe.cn/docs/api/id/166](https://www.juhe.cn/docs/api/id/166)
如果key参数不对,是不会请求成功的!
# coding:utf-8
import requests
url = "http://japi.juhe.cn/qqevaluate/qq"
par = {
"key": "******************", # appkey需要注册申请
"qq": "283340479"
}
r = requests.get(url, params=par)
print(r.text) # 打印文本
res = r.json() # 返回的是json,用r.json解析器转成字典
# 字典取某个字段
conclusion = res["result"]["data"]["conclusion"]
print(conclusion)
analysis = res["result"]["data"]["analysis"]
print(analysis)
- Mesos+Zookeeper+Marathon的Docker管理平台部署记录(2)--负载均衡marathon-lb
- Docker集群管理工具-Kubernetes部署记录
- AS3:小游戏“贪吃蛇”的实现
- 超实用的8个Linux命令行性能监测工具
- 用javascript替换URL中的参数值
- Gitblit版本服务器环境部署记录
- HDK扩展自定义VEX函数print
- AsyncTask和Handler对比
- sql初始化XML操作
- 给你一根杠杆,撬起万亿的小程序红利市场!
- Flash/Flex学习笔记(43):动量守恒与能量守恒
- Flash/Flex学习笔记(57):实用技巧
- 使用 MEF 轻松实现云部署
- 检测常见ASP.NET配置安全漏洞
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- springmvc实例之删除雇员相关信息(三)
- 信号
- 操作系统实验之存储管理第二版
- 守护进程
- 【tensorflow2.0】自动微分机制
- Vue3.0 beta版学习笔记
- 【tensorflow2.0】低阶api--张量操作、计算图、自动微分
- mybatis之第一个mybatis程序(一)
- 进程间通信
- django-表单之创建表单(一)
- 原来sqlite3_get_table() 是这样抓取数据的!!!
- 【tensorflow2.0】中阶api--模型、损失函数、优化器、数据管道、特征列等
- 最短路径Dijkstra算法的简单实现
- django-表单之获取表单信息(二)
- 【tensorflow2.0】高阶api--主要为tf.keras.models提供的模型的类接口