九、企业微信接口测试实战、Swagger简介

以企业微信API进行实战

• 企业微信API官网：https://work.weixin.qq.com/api/doc
  
  image.png

Swagger测试流程

• API管理工具：https://swagger.io/
  • swagger editor：可以编辑api
  • swagger codegen：后端用于打桩
  • swagger ui：查看api

image.png

• 接口规范：前端开发、后端开发、产品、测试
• 前端开发：使用generate server生成一个stub
• 后端开发：使用generate client生成一个调用的client sdk
• 测试：使用swagger ui浏览、了解api，自动生成基础测试用例并完善丰富更多用例

测试企业微信标签管理接口

image.png

• requests库：https://docs.python-requests.org/zh_CN/latest/

• 获取corpid：

  
  
  image.png

• 获取corpsecret：

  
  
  image.png

• 获取token

r = requests.get(
        "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
        params={"corpid": corpid, "corpsecret": corpsecret}
    )
    token = r.json()["access_token"]

• 创建标签初步代码框架：

import json
import requests as requests


corpid = "" # 企业id
corpsecret = ""
def test_tag_get():
    """获取token"""
    r = requests.get(
        "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
        params={"corpid": corpid, "corpsecret": corpsecret}
    )
    token = r.json()["access_token"]

    """创建标签"""
    url = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag"
    r = requests.post(
        url,
        params={"access_token":token},
        json={
            "group_id": "GROUP_ID",
            "group_name": "GROUP_NAME",
            "order": 1,
            "tag": [{
                "name": "TAG_NAME_1",
                "order": 1
            },
            {
                "name": "TAG_NAME_2",
                "order": 2
            }
            ],
            "agentid" : 1000014
            }
    )
    print(r.json())
    print(json.dumps(r.json(), intent=2)) # intent=2 会让结果间隔两个空格
    assert r.status_code == 200
    assert r.json()['errcode'] == 0

• 现存问题：
  • 代码冗余
  • 与底层框架耦合太多
  • 封装层次不足，不利于管理

API Object

• po层：业务管理、业务功能的封装
• testcase：与底层无关，只是业务功能的调用
• tag.py

#!/user/bin/env python
# -*- coding: utf-8 -*-
import json

import requests

corpid = "" # 企业id
corpsecret = ""

class Tag:

    def __init__(self):
        self.token = ""

    def get_token(self):
        """获取token"""
        r = requests.get(
            "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
            params={"corpid": corpid, "corpsecret": corpsecret}
        )
        self.token = r.json()["access_token"]

    def list(self):
        """获取tag列表"""
        r = requests.get(
            "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list",
            params={"access_token=": self.token},
            json={
                "tag_id":[]
            }
        )
        print(json.dumps(r.json(), intent=2))  # intent=2 会让结果间隔两个空格
        return r

    def add(self, group_name, tags):
        url = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag"
        r = requests.post(
            url,
            params={"access_token": self.token},
            json={
                "group_id": "GROUP_ID",
                "group_name": group_name,
                "order": 1,
                "tag": tags,
                "agentid": 1000014
            }
        )
        # print(r.json())
        print(json.dumps(r.json(), intent=2))  # intent=2 会让结果间隔两个空格
        return r

• test_tag.py

#!/user/bin/env python
# -*- coding: utf-8 -*-
import pytest

from Exercises.service.tag import Tag


# todo: 代码冗余
# todo: 与底层架构耦合太多
# todo: 封装层次不足，不利于管理

class TestTag:

    def setup_class(self):
        # todo: 数据清理过程，把测试数据清空或还原
        self.tag = Tag()
        self.tag.get_token()

    def test_tag_list(self):
        """获取标签列表"""
        r = self.tag.list()
        assert r.status_code == 200
        assert r.json()["errcode"] == 0

    @pytest.mark.parametrize("group_name, tag_names", [
        ["group1", [{"name": "tag1"}]],
        ["group2", [{"name": "tag2"}, {"name": "tag3"}]]
    ])
    def test_tag_get(self, group_name, tag_names):
        # todo: 完善功能测试
        """创建标签"""
        r = self.tag.add(group_name=group_name, tags=tag_names)
        assert r.status_code == 200
        assert r.json()['errcode'] == 0

        """校验列表"""
        r = self.tag.list()
        assert r.status_code == 200
        assert r.json()["errcode"] == 0

        group = [group for group in r.json()["tag_group"] if group["group_name"] == group_name][0]
        tags = [{"name": tag['name']} for tag in r.json()["tag"]]
        print(group)
        print(tags)
        assert group['group_name'] == group_name
        assert tags == tag_names

    def test_tag_fail(self):
        pass

Tips：在Pycharm中将重复的数据创建变量的方法

image.png