Download OpenAPI specification:
已确认的目标软件契约,当前后端代码尚未实现,待硬件团队同步及真机联调,不代表甲方冻结。 测试环境 Host 为 rooive.weavemeta.cn;HTTPS 网关路径前缀以部署配置为准,该 Host 不代表生产环境地址。 只实现底座归属到创建会话的登录账号,不包含家庭模型或项圈 Pogo 激活。 首次激活使用出厂固定 bootstrap password;成功后由后端生成并返回每设备独立 mqttToken。 详细时序、BLE 映射和错误语义见配网流程说明,MQTT 契约见 MQTT AsyncAPI。
id 为完整 SN。此次配网创建记录的 deviceType 为 base,App 必须与项圈区分展示; 底座归属成功不代表家庭创建或项圈已激活。
{- "message": "success",
- "status": 200,
- "timestamp": 0,
- "result": [
- {
- "id": "string",
- "userId": "string",
- "alias": "string",
- "deviceType": "base",
- "provisioningSessionId": "string",
- "bindTime": 0
}
]
}已归属底座(包括本人)拒绝创建。同账号同 SN 创建新会话会取消旧 pending; 不同账号可各有 pending,最终需设备证明并原子创建唯一归属。token 只在创建时返回。
| deviceId required | string (DeviceId) ^[A-Za-z0-9_-]{1,64}$ 已登记底座的完整 SN,与 JetLinks deviceId 一致。 |
| alias | string or null <= 128 characters |
{- "deviceId": "BSN202607240001",
- "alias": "Home base"
}{- "message": "success",
- "status": 200,
- "timestamp": 0,
- "result": {
- "sessionId": "string",
- "deviceId": "string",
- "expiresAt": 0,
- "status": "pending",
- "token": "string"
}
}不回传 token、固定 password 或 mqttToken;只有 completed 才表示归属成功。
| sessionId required | string (SessionId) ^[0-9a-f]{32}$ 16 随机字节的小写 HEX;BLE 按原序解码为 16 字节。 |
{- "message": "success",
- "status": 200,
- "timestamp": 0,
- "result": {
- "sessionId": "string",
- "deviceId": "string",
- "expiresAt": 0,
- "status": "pending"
}
}不接受消费者 Bearer token。设备必须发送 Authorization: Device
| 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;禁止普通日志/埋点记录。 |
{- "deviceId": "BSN202607240001",
- "sessionId": "00112233445566778899aabbccddeeff",
- "token": "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f"
}{- "message": "success",
- "status": 200,
- "timestamp": 0,
- "result": {
- "deviceId": "string",
- "mqttToken": "string"
}
}