Device Requesting Time Synchronization

Function

This API is used by a device to send a request for synchronizing time with the platform.

Topic

Topic: $oc/devices/{device_id}/sys/events/up

Parameters

Parameter	Mandatory or Optional	Type	Description
object_device_id	Optional	String	Indicates the device that the event is about. If this parameter is not carried, the device specified in the topic is considered to be the device involved.
services	Optional	List<ServiceEvent>	Indicates a list of services that the event is about.

ServiceEvent structure

Parameter	Mandatory or Optional	Type	Description
service_id	Mandatory	String	System field. The value is fixed to $time_sync.
event_type	Mandatory	String	System field. The value is fixed to time_sync_request.
event_time	Optional	String	Indicates the time when the event occurs.
paras	Mandatory	Object	Indicates the event parameters in JSON format.

paras structure

Parameter	Mandatory or Optional	Type	Description
device_send_time	Mandatory	long	Indicates the timestamp when the device sends the request. The timestamp is the number of milliseconds since 00:00:00 on January 1, 1970 in Greenwich Mean Time (GMT).

Example

Topic: $oc/devices/{device_id}/sys/events/up  
Data format:
{ 
    "object_device_id": "{object_device_id}", 
    "services": [{ 
        "service_id": "$time_sync", 
        "event_type": "time_sync_request", 
        "event_time": "20151212T121212Z",
         "paras": { 
            "device_send_time": 1582685678789
         } 
    }] 
}

Parent topic: Device Time Synchronization

Previous topic: Device Time Synchronization

Next topic: Platform Responding to a Request for Time Synchronization