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

hogwarts_wenzi · 2022 年9 月 18 日 01:36

实战目标

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

课程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框架

课后作业

实现tag （标签）接口的增删改查

joker108 · 2022 年9 月 19 日 10:13

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

1870818863_8639 · 2022 年9 月 25 日 06:09

# 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

NickGuo · 2022 年9 月 26 日 14:44

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"]