Postman软件安装

  1. 下载Postman

  2. 安装Postman（Windows系统）

    • 运行安装程序：下载完成后，双击安装包（如.exe文件）开始安装。

    • 遵循安装向导：按照安装向导的指示，选择安装路径（虽然默认可能是C盘，但你可以选择其他位置），同意使用条款，按需选择是否创建桌面快捷方式等。

    • 完成安装：点击“Install”按钮进行安装。安装完成后，根据提示重启Postman或直接启动。

控制软件准备

  1. 安装PAEDUIO™ V 1.1.0或以上版本系统软件。

  2. 创建至少一个预录语音、背景音乐或紧急广播。

  3. 创建一个用于测试REST API的管理员用户。

数据准备

  1. USB许可证序列号。

  2. 安装系统软件的服务器IP地址。

  3. 用于测试REST API的管理员用户名和密码。

Postman准备

  1. 启动"Postman"。

  2. 在"My Workspace"或新建一个Workspace中导入测试环境和测试用例。

  3. 在Workspace标签页导入测试脚本"Import" → "Files"，选择需要导入的测试用例"PAEDUIO_Postman_Collection.json"。

  4. 在Workspace标签页导入测试环境变量: "Import" → "Files"，选择需要导入的测试环境"PAEDUIO_Postman_Environment.json"。

  5. 选择环境变量并激活："Set active"。

  6. 如果需要修改环境变量，在"Current value"中修改并点击菜单保存。

Variable

说明

IP

系统软件服务器的IP地址

secretkey

USB许可证序列号

username

管理员用户名

password

管理员密码
Important
 脚本执行过程中，将在Globals中生成临时变量，临时变量不需要手动修改。

测试脚本每一个使用说明

  • 左侧标签页 "Collections"并展开"PAEDUIO COLLECTION"。

  • 选择需要执行的测试用例，点击"Send"执行。

测试用例

登录

  • 使用所提供的管理员用户名和密码进行登录，登录成功后返回token，后续测试用例需要使用token进行鉴权。

  • 所有其他接口的前置操作

  • 返回结果示例：

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRUeXBlIjoiYXBpIiwiaXNEZXYiOmZhbHNlLCJhY2NvdW50IjoicmVzdGFwaSIsInRpbWVzdGFtcCI6MTcyOTAzOTUxOTEwNH0.xlFSi5y16z6Oev4QDgUmm0sg1PJipOVUxw0byLTI-1g",
        "freshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRUeXBlIjoiYXBpIiwiZXhwIjoxNzMxNjMxNTE5LCJhY2NvdW50IjoicmVzdGFwaSJ9.WYjQxZQ_pmim4PnTI44KjXAnVaihSX74BvA0CdWAJeo",
        "expires": 900
    },
    "timestamp": 1729039519119
}

查询分区组信息

  • 查询系统软件中已建立的分区组信息

  • 将查询得到的第一个分区组ID作为变量groupID进行保存，后续接口需要使用groupID进行分区组操作

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": [
        {
            "id": 579103178612805,
            "name": "1"
        }
    ],
    "timestamp": 1723535424252,
    "totalCount": 1,
    "pageSize": 1,
    "currPage": 1,
    "totalPage": 1
}

查询分区信息

  • 查询系统软件中的分区信息

  • 将查询得到的第一个分区ID作为变量DeviceId进行保存，后续接口需要使用DeviceId进行分区操作

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": [
        {
            "id": "150-015-08394-20221213-00140",
            "name": "PRP-IM2C1A"
        }
    ],
    "timestamp": 1723535457633,
    "totalCount": 1,
    "pageSize": 1,
    "currPage": 1,
    "totalPage": 1
}

查询分区详情

  • 查询系统软件中第一个分区的详细信息，包括音量、是否故障、是否忙碌等

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "fault": false,
        "busy": false,
        "volume": 0,
        "id": "150-015-08394-20221213-00140",
        "name": "PRP-IM2C1A"
    },
    "timestamp": 1723535583038
}

设置分区音量

  • 测试用例将查询到的第一个分区的音量设置为50

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": null,
    "timestamp": 1727161891550
}

查询预设任务

  • 查询系统软件中已预设的任务信息

  • 将查询得到的第一个任务ID作为变量taskID进行保存，后续接口需要使用taskID进行任务操作

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": [
        {
            "id": 579103922839621,
            "name": "测试任务",
            "type": 1
        }
    ],
    "timestamp": 1723535751236,
    "totalCount": 1,
    "pageSize": 1,
    "currPage": 1,
    "totalPage": 1
}

开始广播

  • 将启动查询得到的第一个预设任务

  • 将得到的广播ID作为变量broadcastID进行保存，后续接口需要使用broadcastID进行广播操作

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": 579172963225669,
    "timestamp": 1723536051464
}

停止广播

  • 测试用例将“开始广播”接口启动的预设任务

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": null,
    "timestamp": 1723536133807
}

获取系统状态

  • 获取系统状态，包括是否故障、是否忙碌等

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "fault": false,
        "evac": false
    },
    "timestamp": 1723536180807
}

刷新token

  • 例刷新token，保持登录状态

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRUeXBlIjoiYXBpIiwiYWNjb3VudCI6ImFkbWluIn0.43bmepjxLDW6lDf2IxZi5nAvu7DQCa61GfqBPXs12KY",
        "freshToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRUeXBlIjoiYXBpIiwiZXhwIjoxNzI2MTI4NDEzLCJhY2NvdW50IjoiYWRtaW4ifQ.ZGfQIOC043t7k2SXJw6I2Eey5IuKSndvp2z45_Eaodw",
        "expires": 900
    },
    "timestamp": 1723536413895
}

登出

  • 登出系统软件，结束登录状态

  • 返回结果示例

{
    "successful": true,
    "code": 200,
    "msg": "Success",
    "data": null,
    "timestamp": 1723536914947
}