GET /api/service/identity/get/
Zwraca informacje serwisowe urządzenia.
Uwierzytelnianie: powerUser
Żądanie
Dział zatytułowany „Żądanie”Treść żądania nie jest używana.
Parametry zapytania
Dział zatytułowany „Parametry zapytania”| Parametr | Wartość | Opis |
|---|---|---|
includePassword | 1 | Jeśli zostanie podany, pole devicePassword jest dodawane do odpowiedzi. W przeciwnym razie hasło nie jest zwracane. |
Przykład: GET /api/service/identity/get/?includePassword=1
Odpowiedź 200
Dział zatytułowany „Odpowiedź 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"}Pola odpowiedzi
Dział zatytułowany „Pola odpowiedzi”| Pole | Typ | Opis |
|---|---|---|
available | wartość logiczna | Dane serwisowe urządzenia są dostępne |
donglePresent | wartość logiczna | Sprzętowy klucz serwisowy jest podłączony |
hasDevicePrivateKey | wartość logiczna | Klucz prywatny urządzenia jest ustawiony |
hasDevicePassword | wartość logiczna | Hasło urządzenia jest ustawione; wartość hasła nie jest ujawniana |
uuid | ciąg znaków | null | Pełny unikatowy identyfikator MCU w formacie XXXXXXXX-XXXXXXXX-XXXXXXXX |
devicePublicKey | ciąg znaków | null | Klucz publiczny urządzenia w formacie base64 protokołu WireGuard |
macAddress | ciąg znaków | Efektywny adres MAC w formacie XX:XX:XX:XX:XX:XX, w tym wartość zastępcza |
isUnique | wartość logiczna | true, jeśli adres MAC odczytano z układu EUI-48; false, jeśli używana jest wartość zastępcza wyprowadzona z identyfikatora UUID MCU |
urlAutoConfig | ciąg znaków | null | Adres URL automatycznej konfiguracji |
manufacturer | ciąg znaków | null | Nazwa producenta |
pinCode | ciąg znaków | null | Kod PIN |
devicePassword | ciąg znaków | null | Hasło urządzenia. Obecne tylko wtedy, gdy zażądano go za pomocą ?includePassword=1 |
Jeśli dane serwisowe urządzenia nie są jeszcze gotowe, API zwraca 503 ERROR_NOT_READY.