ThingsBaord3.9.1的API使用及Apifox测试方法

        最近在整理thingsboard课程，基于最新thingsboard版本3.9.1/4.0，欢迎大家收藏、关注我，提问，在评论区留言，我争取把最新、最准、最好的课程，呈现在各位亦师亦友的csdn广大读者面前。

目录

thingsboard的API测试方法

（一）简单测试，推荐使用swagger

（二）专业测试，推荐使用Apifox (token自动获取)

        （1）配置全局变量token

        （2）登录接口增加后置操作-自定义脚本，目的是给全局变量gtoken赋值。

        （3）在根目录上配置token

        （4）在子目录或在Api接口上，选择Auth，选择继承。（--缺省都是这样）

        （5）开始测试。

thingsboard的API测试方法

（一）简单测试，推荐使用swagger

ThingsBoard提供了Swagger UI界面，方便我们查看和测试其REST API，启动thingsboard之后，在浏览器输入：http://localhost:8080/swagger-ui/index.html

基本使用方法
浏览API：Swagger UI会显示所有可用的API端点，按控制器分类

授权：
点击顶部"Authorize"按钮
输入你的ThingsBoard登录凭据（通常是租户管理员账户的token）
格式为：username:password（base64编码会自动处理）

如何获取登录凭据token呢，在windows环境下，打开Powershell，输入命令：

curl -Uri 'http://localhost:8080/api/auth/login' -Method 'POST' -ContentType 'application/json' -Body '{"username":"tenant@thingsboard.org", "password":"tenant"}' | Select -ExpandProperty Content

执行结果截图如下：

 测试API：
展开你感兴趣的API，点击"Try it out"按钮，
填写所需参数（如果有），点击"Execute"执行请求，即可。

比如，测试时，首先需要输入用户名和密码，之后可以针对每一项api可以单独测试。

ThingsBoard Swagger通常包含以下API组：
Auth - 认证相关API；
Device - 设备管理API；
Asset - 资产管理API；
Customer - 客户管理API；
Dashboard - 仪表板API；
Telemetry - 遥测数据API；
Rule Engine - 规则引擎API。

（二）专业测试，推荐使用Apifox (token自动获取)

在sewagger上导出api文档，再导入到Apifox软件中，如下：

配置Apifox，使用自动获取token，如下步骤：

        （1）配置全局变量token

        （2）登录接口增加后置操作-自定义脚本，目的是给全局变量gtoken赋值。

JS脚本如下：

if (pm.response.code === 200) {
    try {
        const responseData = pm.response.json();
        if (responseData.token) {
            pm.environment.set("token", responseData.token);
            console.log("Token set successfully");
        } else {
            console.error("Token not found in response");
        }
        if (responseData.refreshToken) {
            pm.environment.set("refreshToken", responseData.refreshToken);
        }
    } catch (e) {
        console.error("Failed to parse response:", e);
    }
} else {
    console.error("Request failed with status:", pm.response.code);
}

        （3）在根目录上配置token

        （4）在子目录或在Api接口上，选择Auth，选择继承。（--缺省都是这样）

        （5）开始测试。

        开始测试时，先执行login-endpoint接口，获取到token，再执行entity-query-controller接口。

结束。