Przejdź do głównej zawartości

POST /api/service/identity/set/

Aktualizuje pola tożsamości inne niż klucz prywatny urządzenia i zapisuje je w pamięci EEPROM.

Uwierzytelnianie: powerUser


Treść żądania musi być obiektem JSON bez dodatkowego obiektu nadrzędnego identity.

{
"urlAutoConfig": "https://example.invalid",
"manufacturer": "Novatek",
"pinCode": "123456"
}
PoleTypWymaganeOpis
urlAutoConfigciąg znakównieAdres URL automatycznej konfiguracji
manufacturerciąg znakównieNazwa producenta
pinCodeciąg znakównieKod PIN

Ograniczenia długości:

  • urlAutoConfig: maksymalnie 63 znaki.
  • manufacturer: maksymalnie 23 znaki.
  • pinCode: maksymalnie 11 znaków.

Pusta treść żądania → 400 ERROR_API_PARSING.

Treść żądania, która nie jest obiektem → 400 ERROR_INVALID_ARGUMENT.

Jeśli nie podano żadnego z obsługiwanych pól → 400 ERROR_INVALID_ARGUMENT.


{}

Jeśli klucz prywatny lub hasło urządzenia nie zostały jeszcze zainicjowane, API zwraca 503 ERROR_NOT_READY.

Pierwsze wypełnienie pustego pola tożsamości jest dozwolone bez klucza serwisowego. Zmiana lub wyczyszczenie wypełnionego już pola wymaga klucza serwisowego, a w razie jego braku zwracany jest błąd dostępu. Przesłanie istniejącej wartości nie jest uznawane za nadpisanie.