Rooive 底座无认领码配网 HTTPS 接口 (1.2.0)

Download OpenAPI specification:

已确认的目标软件契约,当前后端代码尚未实现,待硬件团队同步及真机联调,不代表甲方冻结。 测试环境 Host 为 rooive.weavemeta.cn;HTTPS 网关路径前缀以部署配置为准,该 Host 不代表生产环境地址。 只实现底座归属到创建会话的登录账号,不包含家庭模型或项圈 Pogo 激活。 首次激活使用出厂固定 bootstrap password;成功后由后端生成并返回每设备独立 mqttToken。 详细时序、BLE 映射和错误语义见配网流程说明,MQTT 契约见 MQTT AsyncAPI。

App provisioning

查询当前账号已归属设备

id 为完整 SN。此次配网创建记录的 deviceType 为 base,App 必须与项圈区分展示; 底座归属成功不代表家庭创建或项圈已激活。

Authorizations:
consumerBearer

Responses

Response samples

Content type
application/json
{
  • "message": "success",
  • "status": 200,
  • "timestamp": 0,
  • "result": [
    ]
}

当前账号创建五分钟底座配网会话

已归属底座(包括本人)拒绝创建。同账号同 SN 创建新会话会取消旧 pending; 不同账号可各有 pending,最终需设备证明并原子创建唯一归属。token 只在创建时返回。

Authorizations:
consumerBearer
Request Body schema: application/json
required
deviceId
required
string (DeviceId) ^[A-Za-z0-9_-]{1,64}$

已登记底座的完整 SN,与 JetLinks deviceId 一致。

alias
string or null <= 128 characters

Responses

Request samples

Content type
application/json
{
  • "deviceId": "BSN202607240001",
  • "alias": "Home base"
}

Response samples

Content type
application/json
{
  • "message": "success",
  • "status": 200,
  • "timestamp": 0,
  • "result": {
    }
}

仅创建账号查询配网结果

不回传 token、固定 password 或 mqttToken;只有 completed 才表示归属成功。

Authorizations:
consumerBearer
path Parameters
sessionId
required
string (SessionId) ^[0-9a-f]{32}$

16 随机字节的小写 HEX;BLE 按原序解码为 16 字节。

Responses

Response samples

Content type
application/json
{
  • "message": "success",
  • "status": 200,
  • "timestamp": 0,
  • "result": {
    }
}

仅创建账号取消尚未完成的会话

只改变 pending;不会解除已完成的账号归属。解绑使用所有者解绑接口。

Authorizations:
consumerBearer
path Parameters
sessionId
required
string (SessionId) ^[0-9a-f]{32}$

16 随机字节的小写 HEX;BLE 按原序解码为 16 字节。

Responses

Response samples

Content type
application/json
{
  • "message": "success",
  • "status": 200,
  • "timestamp": 0
}

Device provisioning

底座激活一机一密并确认账号归属

不接受消费者 Bearer token。设备必须发送 Authorization: Device ;首次激活时 credential 为出厂固定 bootstrap password,已激活设备除原已完成会话的幂等重试外,只能使用当前 mqttToken。请求体 token 同时证明本次近场会话。首次成功时后端生成、保存并返回 mqttToken;原会话到期前相同请求 必须返回同一个 mqttToken,不重复生成或绑定;该重试可继续携带原固定 password,但不得用于新会话。 解绑不允许设备回退使用固定 password。

Authorizations:
deviceCredential
Request Body schema: application/json
required
deviceId
required
string (DeviceId) ^[A-Za-z0-9_-]{1,64}$

已登记底座的完整 SN,与 JetLinks deviceId 一致。

sessionId
required
string (SessionId) ^[0-9a-f]{32}$

16 随机字节的小写 HEX;BLE 按原序解码为 16 字节。

token
required
string (SecretHex) ^[0-9a-f]{64}$

32 字节的小写 HEX;禁止普通日志/埋点记录。

Responses

Request samples

Content type
application/json
{
  • "deviceId": "BSN202607240001",
  • "sessionId": "00112233445566778899aabbccddeeff",
  • "token": "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f"
}

Response samples

Content type
application/json
{
  • "message": "success",
  • "status": 200,
  • "timestamp": 0,
  • "result": {
    }
}