Przejdź do głównej zawartości

GET /api/service/identity/get/

Zwraca informacje serwisowe urządzenia.

Uwierzytelnianie: powerUser


Treść żądania nie jest używana.

ParametrWartośćOpis
includePassword1Jeś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


{
"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"
}
PoleTypOpis
availablewartość logicznaDane serwisowe urządzenia są dostępne
donglePresentwartość logicznaSprzętowy klucz serwisowy jest podłączony
hasDevicePrivateKeywartość logicznaKlucz prywatny urządzenia jest ustawiony
hasDevicePasswordwartość logicznaHasło urządzenia jest ustawione; wartość hasła nie jest ujawniana
uuidciąg znaków | nullPełny unikatowy identyfikator MCU w formacie XXXXXXXX-XXXXXXXX-XXXXXXXX
devicePublicKeyciąg znaków | nullKlucz publiczny urządzenia w formacie base64 protokołu WireGuard
macAddressciąg znakówEfektywny adres MAC w formacie XX:XX:XX:XX:XX:XX, w tym wartość zastępcza
isUniquewartość logicznatrue, jeśli adres MAC odczytano z układu EUI-48; false, jeśli używana jest wartość zastępcza wyprowadzona z identyfikatora UUID MCU
urlAutoConfigciąg znaków | nullAdres URL automatycznej konfiguracji
manufacturerciąg znaków | nullNazwa producenta
pinCodeciąg znaków | nullKod PIN
devicePasswordciąg znaków | nullHasł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.