diff --git a/锁初始化到远程开锁.md b/锁初始化到远程开锁.md new file mode 100644 index 0000000..dabbf74 --- /dev/null +++ b/锁初始化到远程开锁.md @@ -0,0 +1,596 @@ + +## APP端添加附近的锁调用接口如下: + +[2026-05-12 15:24:29] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/initialize", + "method": "POST", + "params": { + "lockAlias": "T9A_c8478c753454", + "position": [], + "bluetooth": { +"bluetoothDeviceId": "T9A_c8478c753454", +"bluetoothDeviceName": "T9A_c8478c753454", +"publicKey": [ +120,157,0,0,220,220,19,29,79,23,202,48,79,222,17,76], +"privateKey": [ +170,158,0,0,7,147,76,83,66,122,195,118,190,124,24,46], +"signKey": [ +170,158,0,0,115,152,196,39,166,73,185,119,240,18,219,126] + }, + "lockInfo": { +"vendor": "XL", +"product": 1, +"model": "JL-BLE-01", +"fwVersion": "1.0.0.230828", +"hwVersion": "1.0.0.230829", +"serialNum0": "T9A_c8478c753454", +"serialNum1": "c8478c753454", +"btDeviceName": "T9A_c8478c753454", +"electricQuantity": 100, +"electricQuantityStandby": 0, +"restoreCount": 26, +"restoreDate": 1778570632000, +"icPartNo": "AC6951", +"indate": 1778570657000, +"mac": "C8:47:8C:75:34:54", +"timezoneOffset": 28800, +"adminPwd": "521675" + }, + "lockUserNo": "256", + "pwdTimestamp": "1778569200000", + "featureValue": "080F058092FB7E07C027", + "featureSettingValue": "000C0100004B7E07C007", + "featureSettingParams": [ +4,29,1,0,30,1,0,33,1,4,67,1,200 + ], + "date": 1778570668000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} + +``` + +[2026-05-12 15:24:29] sky.INFO: BehaviorRecordEvent: ["Startlockcn\\StarCoreUtils\\Record\\Cloud\\Lock\\LockRecord",10,52,11023,{"lockId":43,"lockName":"T9A_c8478c753454"},0] + +[2026-05-12 15:24:29] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/initialize", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} + +``` + + +[2026-05-12 15:24:29] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/detail?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570669000&lockId=43", + "method": "GET", + "params": { + "lockId": "43", + "date": "1778570669000", + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +``` + +} + +[2026-05-12 15:24:29] sky.INFO: API请求响应日志 +{ + "url": "https://tcloud.skychip.top/api/v1/lock/detail?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570669000&lockId=43", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} + + +[2026-05-12 15:24:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/getLockStatus?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570669000&lockId=43", + "method": "GET", + "params": { + "lockId": "43", + "date": "1778570669000", + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + + +[2026-05-12 15:24:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/getLockStatus?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570669000&lockId=43", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + + + +[2026-05-12 15:24:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/getLockFeatureList?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570670000&lockId=43", + "method": "GET", + "params": { + "lockId": "43", + "date": "1778570670000", + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + + +[2026-05-12 15:24:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/getLockFeatureList?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570670000&lockId=43", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + +[2026-05-12 15:24:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/lockBasicInfo?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570670000&lockId=43", + "method": "GET", + "params": { + "lockId": "43", + "date": "1778570670000", + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + + +[2026-05-12 15:24:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/lockBasicInfo?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570670000&lockId=43", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + +[2026-05-12 15:24:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lockSetting/getLockSetting?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570670000&lockId=43", + "method": "GET", + "params": { + "lockId": "43", + "date": "1778570670000", + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + +[2026-05-12 15:24:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lockSetting/getLockSetting?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570670000&lockId=43", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + + +## 配网调用接口如下: +[2026-05-12 15:28:22] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/gateway/getGatewayConfig", + "method": "POST", + "params": { + "date": 1778570902000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + +[2026-05-12 15:28:23] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/gateway/getGatewayConfig", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + +[2026 - 05 - 12 15: 28: 27] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/deviceNetwork/setting", + "method": "POST", + "params": { + "deviceType": 2, + "deviceMac": "C8:47:8C:75:34:54", + "wifiName": "TLINKTECH04", + "networkMac": "C8:47:8C:75:34:54", + "secretKey": "U6QeCCnIx1qeOnBy5K", + "peerId": "J9eiRddvhsr19UrMg3qNfRK9b1ngzH1rSvVeFBDwfhDV", + "date": 1778570907000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + +[2026-05-12 15:28:27] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/deviceNetwork/setting", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + +[2026 - 05 - 12 15: 28: 28] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/syncLockSetting", + "method": "POST", + "params": { + "lockId": 43, + "featureSettingParams": [8, 5, 3, 1, 1, 10, 29, 1, 0, 30, 1, 1, 33, 1, 4, 41, 1, 1, 58, 1, 2, 64, 13, 1, 0, 0, 0, 0, 0, 1, 0, 0, 1, 10, 0, 0, 67, 1, 200], + "date": 1778570908000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + +[2026-05-12 15:28:28] sky.INFO: 同步锁设置上传 +``` +[ + { + "lockId": 43, + "featureSettingParams": [8,5,3,1,1,10,29,1,0,30,1,1,33,1,4,41,1,1,58,1,2,64,13,1,0,0,0,0,0,1,0,0,1,10,0,0,67,1,200], + "date": 1778570908000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +] +``` + +[2026-05-12 15:28:28] sky.INFO: BehaviorRecordEvent: ["Startlockcn\\StarCoreUtils\\Record\\Cloud\\Lock\\LockRecord",10,52,11023,{"lockId":43,"lockName":"T9A_c8478c753454"},0] + +[2026-05-12 15:28:28] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/syncLockSetting", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} + +``` + +[2026-05-12 15:28:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/list?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570910000&pageNo=1&pageSize=10000", + "method": "GET", + "params": { + "pageNo": "1", + "pageSize": "10000", + "date": "1778570910000", + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} + +``` + +[2026-05-12 15:28:30] sky.INFO: group {"group":[75,96]} +[2026-05-12 15:28:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/list?accessToken=WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr&clientId=kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM&clientSecret=Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN&date=1778570910000&pageNo=1&pageSize=10000", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} + +``` + +重复一次lock/list + +[2026-05-12 15:28:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/getLockCount", + "method": "POST", + "params": { + "type": 2, + "date": 1778570910000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} + +``` + +[2026-05-12 15:28:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lock/getLockCount", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + +[2026-05-12 15:28:30] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/userStarchart/getUserStarchart", + "method": "POST", + "params": { + "date": 1778570910000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} +``` + + + +[2026-05-12 15:28:30] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/userStarchart/getUserStarchart", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + + + +## 允许远程开锁调用的接口如下: +[2026-05-12 15:30:03] sky.INFO: API请求 +{ + "url": "https://tcloud.skychip.top/api/v1/lockSetting/updateLockSetting", + "method": "POST", + "params": { + "lockId": 43, + "remoteUnlock": 1, + "date": 1778571003000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} + +[2026-05-12 15:30:03] sky.INFO: BehaviorRecordEvent: ["Startlockcn\\StarCoreUtils\\Record\\Cloud\\Lock\\LockRecord",10,52,11023,{"lockId":43,"lockName":"T9A_c8478c753454"},0] + +[2026-05-12 15:30:03] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/lockSetting/updateLockSetting", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + + + + + +## 点击远程开锁调用的接口如下: +[2026-05-12 15:30:47] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/gateway/unlock", + "method": "POST", + "params": { + "lockId": "43", + "date": 1778571047000, + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "clientSecret": "Txg1VuF2DWFrKGPIoIr62vmDAsRUPtqN", + "accessToken": "WiStaIPv0fwajrxGNqvAlGbFgvv3eZwabl13q4pr" + } +} + +``` + +[2026-05-12 15:30:47] sky.INFO: rpc + +``` +http://tchart.skychip.top:8718/rpc +method: starlock.BleUnlock; +param1: +{ + "ToUserId": "J9eiRddvhsr19UrMg3qNfRK9b1ngzH1rSvVeFBDwfhDV", + "BluetoothDeviceName": "T9A_c8478c753454", + "Pk": "[120,157,0,0,220,220,19,29,79,23,202,48,79,222,17,76]", + "Sk": "[170,158,0,0,7,147,76,83,66,122,195,118,190,124,24,46]", + "Sign": "[170,158,0,0,115,152,196,39,166,73,185,119,240,18,219,126]", + "Uid": "11023", + "OnlineToken": "", + "Token": 0 +} +``` + + +[2026-05-12 15:30:48] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/v1/gateway/unlock", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + +[2026-05-12 15:30:49] sky.INFO: API请求 + +``` +{ + "url": "https://tcloud.skychip.top/api/gateway/lockEventReport", + "method": "POST", + "params": { + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "secretKey": "U6QeCCnIx1qeOnBy5K", + "bluetoothDeviceMac": "C8:47:8C:75:34:54", + "type": "records", + "lockRecords": [ + { + "type": 36, + "timestamp": 1778571048, + "success": 1, + "password": null, + "user": 0, + "imageUrl": null, + "videoUrl": null + } + ] + } +} +``` + + +[2026-05-12 15:30:49] sky.INFO: lockEventReport + +``` +{ + "clientId": "kxEtIW7kGV8hq5nie9jVPgGNSeM0cSqM", + "secretKey": "U6QeCCnIx1qeOnBy5K", + "bluetoothDeviceMac": "C8:47:8C:75:34:54", + "type": "records", + "lockRecords": [ + { +"type": 36, +"timestamp": 1778571048, +"success": 1, +"password": null, +"user": 0, +"imageUrl": null, +"videoUrl": null + } + ] +} +``` + +[2026-05-12 15:30:50] sky.INFO: BehaviorRecordEvent: ["Startlockcn\\StarCoreUtils\\Record\\Cloud\\Lock\\LockRecord",10,54,11023,{"lockId":43,"lockName":"T9A_c8478c753454"},0] + +[2026-05-12 15:30:50] sky.INFO: API请求响应日志 + +``` +{ + "url": "https://tcloud.skychip.top/api/gateway/lockEventReport", + "params": { + "errcode": 0, + "errmsg": "none error message", + "description": "" + } +} +``` + + +lockEventReport重复一次