GET /api/service/identity/get/
Return device service information.
Auth: Bearer (powerUser).
Request
Section titled “Request”The request body is not used.
Query parameters
Section titled “Query parameters”| Parameter | Value | Description |
|---|---|---|
includePassword | 1 | If specified, the devicePassword field is added to the response. Otherwise, the password is not returned. |
Example: GET /api/service/identity/get/?includePassword=1
Response 200
Section titled “Response 200”{ "available": true, "donglePresent": true, "hasDevicePrivateKey": true, "hasDevicePassword": true, "uuid": "002B003A-3234510F-38383235", "devicePublicKey": "base64...", "macAddress": "00:11:22:33:44:55", "isUnique": true, "urlAutoConfig": "https://example.invalid", "manufacturer": "Novatek", "pinCode": "123456", "devicePassword": "Ab12Cd34"}Response fields
Section titled “Response fields”| Field | Type | Description |
|---|---|---|
available | boolean | Device service data is available |
donglePresent | boolean | The hardware service dongle is present |
hasDevicePrivateKey | boolean | The device private key is set |
hasDevicePassword | boolean | The device password is set; the password value is not disclosed |
uuid | string | null | Full MCU unique ID in XXXXXXXX-XXXXXXXX-XXXXXXXX format |
devicePublicKey | string | null | Device public key in WireGuard base64 format |
macAddress | string | Effective MAC address in XX:XX:XX:XX:XX:XX format, including the fallback value |
isUnique | boolean | true if the MAC address was read from the EUI-48 chip; false if the fallback derived from the MCU UUID is used |
urlAutoConfig | string | null | Auto-configuration URL |
manufacturer | string | null | Manufacturer string |
pinCode | string | null | PIN code |
devicePassword | string | null | Device password. Present only when requested with ?includePassword=1 |
If the device service data is not ready yet, the API returns 503 ERROR_NOT_READY.