Checkin

Those endpoints perform check-in procedures, a'ka firmware verification and setup of RTC based on trusted data.

These two endpoints are wide open and do not need any authorization data.

Phase 1 - Challange

Checkin challange

GET https://my.ence.do/api/system/checkin

Get a device checkin challenge data.

200: OK Successful operation

{
  "check": "eyJlY2RoIjoieDI1NTE5IiwidHlwIjoiSldUIiwiYWxnIjoiSFMyNTYifQ.eyJqdGkiOiJrSUEzWXJDQWJpMXZDVTFoOHlwbjJLdHMxUVNET1FVS05zYVVJZ1dvU3IwPSIsImlzcyI6IjBrUm1DbGlVUXZSd2Z4aTdUMWVrMkd0YlNFUnpNRlJHTGV5TzFyMXRFWG89IiwicWlkIjoiZTZQQXZDWnJtTWMwZlVUMEt6bUw3STNUSXo2UUZBNEpCallzbEU5ZisvQT0iLCJhdWQiOiIvTGJ4bzVNZ1U2Wk90VnN4eEc1akNRNSs0ZXd4b2ExclY4ZXFNSUZGblRBPSIsImZ3cyI6Ilora0FhamdWVmRTTVFqTkl2SzVGR3owKzlyZi9KdXRWQ2xOWTZTN0dCZVE3NjVOTVlFVC9YZ2RBNjFjbU1rMTV3YXcwOG9OTHVXbVV5Z0hLM3hXRkNBPT0iLCJibHMiOiI4TXdvd3NLa3hnRVdubDJrMHQvZU92c2pUYlI3MHBvWUMyY3p5UEl3S24vaFZMNjhXRjNRYVF3WjFieFZjWXY3ZzhXRXd5ekoyUFZuVEZBbFlRN2hCZz09IiwidWlzIjoiNkdoMmNDcVNKMEdVTFFLRTFEaWJvWTFPc0M4ck01KzF4UFpjbENuaHRybz0iLCJjc24iOiJLZnNhS0t2Tmw0THZQaWdsMEdtR0JnPT0ifQ.dn2cwBODoUKkGKrr92IW13NgVg7j-h6VGO-tnADqins"
}

Response data for successful operation

Name	Type	Description
check	String	Check-In challenge data generated by HEM

Phase 2 - Response

Checkin response

POST https://my.ence.do/api/system/checkin

Process server response for the device check challenge.

Headers

Name	Type	Description
Content-Type*	String	application/json

Request Body

Name	Type	Description
checked*	String	Checkin data sent by backend server

200: OK Successful operation

{
  "status": "OK"
}

400: Bad Request Incorrect argument(s)

401: Unauthorized Provided data validation failed

Response data for successful operation

Name	Type	Description
newcrt	String	Status of x509 certificate update.
newfws	String	Info about new firmware version.
newuis	String	Info about new Manager version (on Encedo PPA only).
status	String	Checkin status - general information.

Log entries

Event	Result	Source
LOG_TYPE_RTC_SET	LOG_RESULT_OK	200 (if RTC is been updated)
LOG_TYPE_SHUTDOWN	LOG_RESULT_OK	200 (if the device shutdown or locked)