ThingsBoard API参考

设备连接和服务器端API。

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”标题。

image

获得JWT令牌,你需要执行以下请求:

本地安装:

  • 替换 $THINGSBOARD_URL127.0.0.1:8080

在线演示:

  • 替换 $THINGSBOARD_URLdemo.thingsboard.io
  • 替换演示帐号 为 tenant@thingsboard.org 用户名
  • 替换演示密码 为 tenant 密码 获取更多详细信息,请参见在线演示页面。
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客户端文档页了解更多详细信息。