9月18日企业微信接口实战1

实战目标

  • 掌握接口测试设计的能力
  • 企业微信的部门管理接口测试

课程ppt

霍格沃兹测试学院 (ceshiren.com)

HTTP 响应的状态码

HTTP状态码(英语:HTTP Status Code)是用以表示网页服务器超文本传输协议响应状态的 3 位数字代码。所有状态码的第一个数字代表了响应的五种状态之一。

1xx(临时响应)

表示临时响应并需要请求者继续执行操作的状态代码。一般是告诉客户端,请求已经收到了,正在处理,别急…

  • 100 (继续) 请求者应当继续提出请求。 服务器返回此代码表示已收到请求的第一部分,正在等待其余部分。
  • 101 (切换协议) 请求者已要求服务器切换协议,服务器已确认并准备切换。

我们平常遇到这种响应状态码的时候很少。因为 HTTP/1.0 协议中没有定义任何 1xx 状态码,所以除非在某些试验条件下,服务器是不可以向此类客户端发送 1xx 响应的。

2XX (成功)

都表示服务器成功处理了请求的状态代码,说明网页可以正常访问。一般表示:请求收悉、我明白你要的、请求已受理、已经处理完成等信息。

  • 200(成功) 找到了该资源,并且一切正常,服务器已成功处理了请求。
  • 201(已创建) 请求成功且服务器已创建了新的资源。
  • 202(已接受) 服务器已接受了请求,但尚未对其进行处理。
  • 203(非授权信息) 服务器已成功处理了请求,但返回了可能来自另一来源的信息。
  • 204(无内容) 服务器成功处理了请求,但未返回任何内容。
  • 205(重置内容) 服务器成功处理了请求,但未返回任何内容。与 204 响应不同,此响应要求请求者重置文档视图(例如清除表单内容以输入新内容)。
  • 206(部分内容) 服务器成功处理了部分 GET 请求。

3xx (重定向)

表示要完成请求,需要进一步操作。需要重定向到其它地方。它让客户端再发起一个请求以完成整个处理

  • 300 (多种选择) 针对请求,服务器可执行多种操作。 服务器可根据请求者 (user agent) 选择一项操作,或提供操作列表供请求者选择。
  • 301 (永久移动) 请求的网页已永久移动到新位置。 服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置。
  • 302 (临时移动) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
  • 303 (查看其他位置) 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码。
  • 304 (未修改) 自从上次请求后,请求的网页未修改过。 服务器返回此响应时,不会返回网页内容。这通常用于浏览器的缓存机制
  • 305 (使用代理) 请求者只能使用代理访问请求的网页。 如果服务器返回此响应,还表示请求者应使用代理。
  • 307 (临时重定向) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。

4xx(请求错误)

这些状态代码表示请求可能出错,责任在客户端,如客户端的请求一个不存在的资源,客户端未被授权,禁止访问等,妨碍了服务器的处理。

  • 400 (错误请求) 服务器不理解请求的语法。
  • 401 (未授权) 请求要求身份验证。对于需要登录的网页,服务器可能返回此响应。 要求用户输入用户名和密码,以登录到服务器。
  • 403 (禁止) 服务器拒绝请求。客户端未能获得授权。这通常是在401之后输入了不正确的用户名或密码。
  • 404 (未找到) 服务器找不到请求的网页。在指定的位置不存在所申请的资源。
  • 405 (方法禁用) 禁用请求中指定的方法。
  • 406 (不接受) 无法使用请求的内容特性响应请求的网页。
  • 407 (需要代理授权) 此状态代码与 401(未授权)类似,但指定请求者应当授权使用代理。
  • 408 (请求超时) 服务器等候请求时发生超时。
  • 409 (冲突) 服务器在完成请求时发生冲突。 服务器必须在响应中包含有关冲突的信息。
  • 410 (已删除) 如果请求的资源已永久删除,服务器就会返回此响应。
  • 411 (需要有效长度) 服务器不接受不含有效内容长度标头字段的请求。
  • 412 (未满足前提条件) 服务器未满足请求者在请求中设置的其中一个前提条件。
  • 413 (请求实体过大) 服务器无法处理请求,因为请求实体过大,超出服务器的处理能力。
  • 414 (请求的 URI 过长) 请求的 URI(通常为网址)过长,服务器无法处理。
  • 415 (不支持的媒体类型) 请求的格式不受请求页面的支持。
  • 416 (请求范围不符合要求) 如果页面无法提供请求的范围,则服务器会返回此状态代码。
  • 417 (未满足期望值) 服务器未满足”期望”请求标头字段的要求。

5xx(服务器错误)

处理发生错误,责任在服务端,如服务端抛出异常,路由出错,HTTP版本不支持等

  • 500 (服务器内部错误) 服务器遇到错误,无法完成请求。 看到这个错误,你就应该查查服务端的日志了,肯定抛出了一堆异常
  • 501 (尚未实施) 服务器不具备完成请求的功能。 例如,服务器无法识别请求方法时可能会返回此代码。
  • 502 (错误网关) 服务器作为网关或代理,从上游服务器收到无效响应。
  • 503 (服务不可用) 服务器目前无法使用(由于超载或停机维护)。 通常,这只是暂时状态。
  • 504 (网关超时) 服务器作为网关或代理,但是没有及时从上游服务器收到请求。
  • 505 (HTTP 版本不受支持) 服务器不支持请求中所用的 HTTP 协议版本。

REST 规范

测试用例与postman脚本

部门管理接口测试用例.xlsx (14.1 KB)
depart_data.zip (15.0 KB)

requests框架

requests框架

课后作业

实现tag (标签)接口的增删改查

tag接口的增删改查操作,代码如下

# -*- coding: UTF-8 -*-
# author: joker
# perject:jy4
# name:test_wechart_tag.py
# date:2022/9/19
import pytest
import requests

class TestDemo:
    def setup_class(self):
        # 获取access_token值
        corpid = "wwa238703bb5cc3035"
        secert = "70ZcTeq40M0UAD6Rj_3I5KBsYXMsuKLfWOx0ccDxizQ"
        url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpid}&corpsecret={secert}"
        # 发出请求
        res = requests.get(url=url)
        self.token = res.json().get('access_token')

    # 添加标签
    def test_add_tag(self, get_paramesize):
        tag_data = {
            "tagname": get_paramesize[0],
            "tagid": get_paramesize[1]
        }
        url = f"https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token={self.token}"
        res = requests.post(url=url, json=tag_data)
        print(res.json())
        assert res.json().get('errcode') == 0

    # 修改标签名称
    def test_update_tag(self, get_paramesize):
        tag_data = {
            "tagid": get_paramesize[1],
            "tagname": get_paramesize[0]+f"{get_paramesize[1]}"
        }

        url = "https://qyapi.weixin.qq.com/cgi-bin/tag/update"
        update_data = {"access_token": self.token}
        res = requests.post(url=url, json=tag_data, params=update_data)
        print(res.json())
        assert res.json().get('errcode') == 0
        assert res.json().get('errmsg') == 'updated'

    # 获取标签列表
    def test_tag_list(self):
        # 获取部门列表
        list_url = f"https://qyapi.weixin.qq.com/cgi-bin/tag/list?access_token={self.token}"
        res = requests.get(url=list_url)
        print(res.json())
        assert res.json().get('errcode') == 0
        assert res.json().get('errmsg') == 'ok'

    # 删除标签
    def test_delete_tag(self, get_paramesize):
        list_url = "https://qyapi.weixin.qq.com/cgi-bin/tag/delete"
        update_data = {"access_token": self.token,
                       "tagid": get_paramesize[1]
                       }
        res = requests.get(url=list_url, params=update_data)
        print(res.json())
        assert res.json().get('errcode') == 0
        assert res.json().get('errmsg') == 'deleted'

  • conftest.py
import pytest

@pytest.fixture(params=[{"name": 'tester', "id": 1}, {"name": 'joker', "id": 2}], scope='class')
def get_paramesize(request):
    name = request.param['name']
    tag_id = request.param['id']
    print(f"标签名称为{name},标签id为{tag_id}")
    return name, tag_id
# author: Junny
# project:pythonProject2
# name: test_tagmange.py
# date: 2022/9/18
import pytest
import requests


class TestTagMange:

    # 前置条件:获取接口access_token
    def setup_class(self):
        # 企业ID
        CORPID = "ww4832d75531f05890"
        # 应用的凭证密钥
        CORPSECRET = "TDAVTDFNwjapv12LBd8L3flOBNspdmrq3aGi2d6lSx8"
        # 应用的基础url
        self.base_url = "https://qyapi.weixin.qq.com/cgi-bin/"
        # 【获取access_token】的请求地址
        token_url = f"{self.base_url}gettoken"
        # 定义请求参数
        token_params = {
            "corpid": CORPID,
            "corpsecret": CORPSECRET
        }
        token_res = requests.get(url=token_url, params=token_params)
        self.access_token = token_res.json().get("access_token")

    # 添加标签
    @pytest.mark.parametrize("tagname, tagid",
                             [("YiLuXiangBei", 1), ("YiLuXiangNan", 2), ("YiLuXiangDong", 3), ("YiLuXiangXi", 4)])
    def test_add_tag(self, tagname, tagid):
        # 【创建标签】的请求地址
        token_url = f"{self.base_url}tag/create"
        # 定义请求参数
        token_params = {
            "access_token": self.access_token
        }
        json_body = {
            "tagname": tagname,
            "tagid": tagid
        }
        res = requests.post(url=token_url, params=token_params, json=json_body)
        assert res.json()["errmsg"] == "created"
        assert res.json().get("errcode") == 0

    # 修改标签
    @pytest.mark.parametrize("tagname, tagid",
                             [("XiangBei", 1), ("XiangNan", 2), ("XiangDong", 3), ("XiangXi", 4)])
    def test_update_tag(self,tagname,tagid):
        # 【修改标签】的请求地址
        token_url = f"{self.base_url}tag/update"
        # 定义请求参数
        token_params = {
            "access_token": self.access_token
        }
        json_body = {
            "tagid": tagid,
            "tagname": tagname
        }
        res = requests.post(url=token_url, params=token_params, json=json_body)
        assert res.json()["errmsg"] == "updated"
        assert res.json().get("errcode") == 0

    # 查询标签
    def test_search_tag(self):
        # 【查询标签】的请求地址
        token_url = f"{self.base_url}tag/list"
        # 定义请求参数
        token_params = {
            "access_token": self.access_token
        }
        res = requests.get(url=token_url, params=token_params)
        assert res.json()["errmsg"] == "ok"
        assert res.json().get("errcode") == 0

    # 删除标签
    @pytest.mark.parametrize("tagid",
                             [1, 2, 3, 4])
    def test_delete_tag(self,tagid):
        # 【删除标签】的请求地址
        token_url = f"{self.base_url}tag/delete"
        # 定义请求参数
        delete_params = {
            "access_token": self.access_token,
            "tagid": tagid
        }
        res = requests.post(url=token_url, params=delete_params)
        assert res.json()["errmsg"] == "deleted"
        assert res.json().get("errcode") == 0
import pytest
import requests

from test_wework.test_token import TestToken


class TestTag:
    def setup_class(self):
        self.token = TestToken.test_get_token(self)

    @pytest.mark.parametrize("tagname, tagid", [
        ("JAVA", 50),
        ("Python", 60)
    ])
    def test_add_tag(self, tagname, tagid):
        url = "https://qyapi.weixin.qq.com/cgi-bin/tag/create"
        req_params = {
            "access_token": self.token
        }
        req_data = {
            "tagname": tagname,
            "tagid": tagid
        }
        r = requests.post(url, params=req_params, json=req_data)
        print(r.json())
        assert 0 == r.json()["errcode"]
        assert "created" == r.json()["errmsg"]
        assert req_data.get("tagid") == r.json()["tagid"]

    def test_upd_tag(self):
        url = "https://qyapi.weixin.qq.com/cgi-bin/tag/update"
        req_params = {
            "access_token": self.token
        }
        req_data = {
            "tagid": 50,
            "tagname": "JAVA design"
        }
        r = requests.post(url, params=req_params, json=req_data)
        print(r.json())
        assert 0 == r.json()["errcode"]
        assert "updated" == r.json()["errmsg"]

    def test_get_tag_list(self):
        url = "https://qyapi.weixin.qq.com/cgi-bin/tag/list"
        req_params = {
            "access_token": self.token
        }
        r = requests.get(url, params=req_params)
        print(r.json())
        assert 0 == r.json()["errcode"]
        assert "ok" == r.json()["errmsg"]

    @pytest.mark.parametrize("tagid", [50, 60])
    def test_del_tag(self, tagid):
        url = "https://qyapi.weixin.qq.com/cgi-bin/tag/delete"
        req_params = {
            "access_token": self.token,
            "tagid": tagid
        }
        r = requests.get(url, params=req_params)
        print(r.json())
        assert 0 == r.json()["errcode"]
        assert "deleted" == r.json()["errmsg"]