Update Device
API Basic Information
API Description: None
Request method: patch
API Request path: /api/v1/cits/devices/{iotId}
API Request parameters
Path request parameters
| parameter name | type | required | remark |
|---|---|---|---|
| iotId | string | Required | Device iotId |
Query parameters
| parameter name | type | required | remark |
|---|---|---|---|
| fields | string | Required | List of fields to be modified, separated by ','. |
Request body
| parameter name | type | required | remark |
|---|---|---|---|
| name | string | Optional | Device name. |
| position | string | Optional | Device location. |
| brand | string | Optional | Device brand |
| remark | string | Optional | Device remark |
| netConfig | DeviceNetConfigRequest | Optional | Network Configuration |
| userConfig | DeviceUserConfigRequest | Optional | User Configuration |
| model | string | Optional | Model |
| sipConfig | DeviceSipConfigRequest | Optional | SIP configuration |
| platform | string | Optional | Device platform Options: UNSPECIFIED - Unknown. NEXHOME - NEXHOME. HTW - HTW |
Response
| parameter name | type | required | remark |
|---|---|---|---|
| id | integer | Optional | Device ID. |
| iotId | string | Optional | Device IOT ID. |
| productId | string | Optional | Corresponding product ID of the device. |
| name | string | Optional | Device name. |
| position | string | Optional | Device location. |
| type | string | Optional | Device type. Options: UNSPECIFIED - Unknown. ACCESS - Access device. INTERCOM - Intercom device. INDOOR - Indoor unit. GATEWAY - Edge gateway. IPC - Camera. CENTER - Master station. ROBOT - Robot. SIGNAGE - Door signage |
| brand | string | Optional | Device brand |
| remark | string | Optional | Device remark |
| mac | string | Optional | Device mac |
| ip | string | Optional | Device IP |
| mask | string | Optional | Subnet mask |
| gateway | string | Optional | Gateway |
| dns | string | Optional | DNS |
| softVersion | string | Optional | Software version |
| softVersionCode | integer | Optional | Software version code |
| hardVersion | string | Optional | Hardware version |
| onlineStatus | string | Optional | Online status, UNSPECIFIED (unknown)/ONLINE (online)/OFFLINE (offline) Optional values: UNSPECIFIED - Unknown state. ONLINE - Online. OFFLINE - Offline. |
| lastOnlineTime | integer | Optional | Last online timestamp (milliseconds) |
| lastOfflineTime | integer | Optional | Last offline timestamp (milliseconds) |
| sn | string | Optional | Device sn |
| sipNumber | string | Optional | Device SIP number (returned for intercom devices) |
| model | string | Optional | Model |
| cover | string | Optional | Device cover file key (currently only for IPC devices). Call /api/v1/cits/devices/{iot_id}/files:generateOssUrl to obtain URL |
| gatewayIotId | string | Optional | Parent device IoT ID (returned when querying sub-devices) |
| spaceId | string | Optional | Space ID (returned when querying sub-devices from edge gateway) |
| spaceName | string | Optional | Space full name (returned when querying sub-devices from edge gateway) |
| spaceLayer | integer | Optional | Space layer (returned when querying sub-devices from edge gateway) |
| developerId | string | Optional | Devloper ID |
| developerAppId | string | Optional | APP-ID |
| createdTime | integer | Optional | Create time |
| lastModificationTime | integer | Optional | Update Time |
| relayList[] | RelayDetail | Optional | Relay list |
| platform | string | Optional | Device platform Options: UNSPECIFIED - Unknown. NEXHOME - NEXHOME. HTW - HTW |
Related data models
Device Network Configuration
nexhome.iotdomain.cits.v1.devices.DeviceNetConfigRequest
| parameter name | type | required | remark |
|---|---|---|---|
| ip | string | Optional | Device IP |
| mask | string | Optional | Subnet mask |
| gateway | string | Optional | Gateway |
| dns | string | Optional | DNS |
Device User Configuration
nexhome.iotdomain.cits.v1.devices.DeviceUserConfigRequest
| parameter name | type | required | remark |
|---|---|---|---|
| language | string | Optional | Language, e.g., en_US, zh_CN, zh_TW, he_IL. |
| timezone | string | Optional | Time zone |
Device SIP Configuration
nexhome.iotdomain.cits.v1.devices.DeviceSipConfigRequest
| parameter name | type | required | remark |
|---|---|---|---|
| transportProtocol | string | Optional | Transport protocol, default TLS Options: UNSPECIFIED - Unknown. UDP - UDP. TCP - TCP. TLS - TLS. |
Device Relay List
nexhome.iotdomain.cits.v1.devices.RelayDetail
| parameter name | type | required | remark |
|---|---|---|---|
| code | integer | Optional | — |
| name | string | Optional | — |