REST API

• Swagger UI
• REST API 认证
• Java REST API客户端

Swagger UI

使用 Swagger UI 调用ThingsBoard REST API。 使用 Swagger UI 调用ThingsBoard专业版REST API服务。

只要安装了ThingsBoard服务，就可以使用以下URL打开UI：

http://YOUR_HOST:PORT/swagger-ui.html

REST API 认证

ThingsBoard使用JWT进行请求身份验证。 您将需要使用Swagger UI右上角的”Authorization“按钮填充“X-Authorization”标题。

获得JWT令牌，你需要执行以下请求：

本地安装：

• 替换 $THINGSBOARD_URL 为 127.0.0.1:8080

在线演示:

• 替换 $THINGSBOARD_URL 为 demo.thingsboard.io
• 替换演示帐号 为 tenant@thingsboard.org 用户名
• 替换演示密码 为 tenant 密码 获取更多详细信息，请参见在线演示页面。

• get-token.sh
• response.json

resources/get-token.sh
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{"username":"tenant@thingsboard.org", "password":"tenant"}' 'http://THINGSBOARD_URL/api/auth/login'

resources/get-token-response.json
{"token":"$YOUR_JWT_TOKEN", "refreshToken":"$YOUR_JWT_REFRESH_TOKEN"}

• 现在你应该将“X-Authorization”设置为“Bearer $YOUR_JWT_TOKEN”

Java REST API客户端

ThingsBoard团队提供了用Java编写的客户端库简化REST API的使用。

请参阅Java REST API客户端文档页了解更多详细信息。