Thingsboard设备预配置：如何通过API在指定设备组中创建新设备？

解决方案 #

ThingsBoard 公开的无认证设备预配置接口 /api/v1/provision 本身不支持直接在请求参数中指定目标设备组，需通过「预配置创建设备+调用设备组分配接口」的两步方案实现，具体操作如下：

前置准备

• 提前获取目标设备组的实体ID：进入ThingsBoard控制台对应设备组页面，浏览器地址栏中groups/后的字符串即为设备组ID，格式为UUID
• 提前获取租户管理员的JWT鉴权Token，可通过登录接口获取：

curl -X POST --header "Content-Type: application/json" -d '{"username":"<租户管理员账号>","password":"<管理员密码>"}' https://thingsboard.cloud/api/auth/login

返回结果中的token字段即为后续接口需要的鉴权凭证。

操作步骤

1. 调用原有预配置接口创建设备，获取返回的设备ID

curl -v -X POST --header "Content-Type: application/json" --header "Accept: application/json" -d "{\"deviceName\":\"<设备名>\",\"provisionDeviceKey\":\"<预配置Key>\",\"provisionDeviceSecret\":\"<预配置密钥>\"}" "https://thingsboard.cloud/api/v1/provision"

接口返回结果中的id.id字段即为新创建设备的UUID，参考返回示例：

{
  "id": {"entityType": "DEVICE", "id": "a1b2c3d4-xxxx-xxxx-xxxx-xxxxxxxx"},
  "name": "你的设备名",
  "credentials": {...}
}

2. 调用设备组分配接口，将新设备加入指定组

curl -v -X POST --header "Content-Type: application/json" --header "X-Authorization: Bearer <租户管理员JWT Token>" -d '["<第一步获取的设备ID>"]' "https://thingsboard.cloud/api/entityGroup/<目标设备组ID>/entities/DEVICE"

如果需要批量操作，可将多个设备ID放在请求的JSON数组中，一次完成多个设备的组分配。

可选优化方案

如果你的预配置逻辑在受信任的服务端执行，不需要暴露给设备端无鉴权调用，可以直接调用带鉴权的创建设备接口一步完成指定组分配，更适合内部批量预配场景。

内容的提问来源于stack exchange，提问作者bmp_sde