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返回状态码

reasonstring 返回原因

resultstring返回实体内容

conclusion string QQ号码测试结论

analysisstring结论分析

五、 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需要注册申请

}

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)

```

  • 发表于:
  • 原文链接http://kuaibao.qq.com/s/20180309G0W3M800?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。

扫码关注云+社区

领取腾讯云代金券