Swagger UI

使用 Swagger UI 调用ThingsBoard REST API。 使用 Swagger UI 调用ThingsBoard专业版REST API服务。
只要安装了ThingsBoard服务,就可以使用以下URL打开UI:

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

REST API 认证

ThingsBoard使用JWT进行请求身份验证。 您将需要使用Swagger UI右上角的”Authorization“按钮填充“X-Authorization”标题。
REST API - 图1
获得JWT令牌,你需要执行以下请求:
本地安装:

  • 替换 $THINGSBOARD_URL127.0.0.1:8080

在线演示:

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

    1. 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'
  • response.json

    1. {"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客户端文档页了解更多详细信息。