Postman软件安装
-
下载Postman
-
安装Postman(Windows系统)
-
运行安装程序:下载完成后,双击安装包(如.exe文件)开始安装。
-
遵循安装向导:按照安装向导的指示,选择安装路径(虽然默认可能是C盘,但你可以选择其他位置),同意使用条款,按需选择是否创建桌面快捷方式等。
-
完成安装:点击“Install”按钮进行安装。安装完成后,根据提示重启Postman或直接启动。
-
控制软件准备
-
安装PAEDUIO™ V 1.1.0或以上版本系统软件。
-
创建至少一个预录语音、背景音乐或紧急广播。
-
创建一个用于测试REST API的管理员用户。
数据准备
-
USB许可证序列号。
-
安装系统软件的服务器IP地址。
-
用于测试REST API的管理员用户名和密码。
Postman准备
-
启动"Postman"。
-
在"My Workspace"或新建一个Workspace中导入测试环境和测试用例。
-
在Workspace标签页导入测试脚本"Import" → "Files",选择需要导入的测试用例"PAEDUIO_Postman_Collection.json"。
-
在Workspace标签页导入测试环境变量: "Import" → "Files",选择需要导入的测试环境"PAEDUIO_Postman_Environment.json"。
-
选择环境变量并激活:"Set active"。
-
如果需要修改环境变量,在"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 }