Getting Specific Event Details of a Device

Description The WSO2 EMM Android client receives different events. Using this API you are able to get the details of the events that belong to a specific event type.

Resource Path /{deviceidentifier}/type/{type}

URL

/mdm-android-agent/events/{deviceidentifier}/type/{type}

HTTP Method GET

Request/Response Format application/json

cURL command

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-android-agent/events/{deviceidentifier}/type/{type}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
Provide APPLICATION_STATE or RUNTIME_STATE as the value for {type}.

Example: Retrieve event details that corresponds to the Android device having the 352317052330505 device ID and alert/event type APPLICATION_STATE.

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer d869e4c177f17143748376d54633473" -k -v https://localhose:9443/mdm-android-agent/events/352317052330505/type/APPLICATION_STATE

Sample output

> GET /mdm-android-agent/events/352317052330505/type/APPLICATION_STATE HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 41e1e511fade79cfe01282fc6a26e3e6
> 
< HTTP/1.1 200 OK
< Date: Sun, 01 May 2016 07:37:18 GMT
< Content-Type: application/json
< Content-Length: 230
< Server: WSO2 Carbon Server
[{"values":{"_version":"1.0.0","payload":"{\"packageName\":\"com.google.android.apps.docs\",\"state\":\"dataCleared\"}",
"type":"APPLICATION_STATE","deviceIdentifier":"352317052330505"},"id":"f0c867ac-8d49-340f-aed4-ae3a34e7ec3c"}]

Sample JSON Output Definition

 [{
	"values": {
		"_version": "1.0.0",
		"payload": "{\"packageName\":\"com.google.android.apps.docs\",\"state\":\"dataCleared\"}",
		"type": "APPLICATION_STATE",
		"deviceIdentifier": "352317052330505"
	},
	"id": "f0c867ac-8d49-340f-aed4-ae3a34e7ec3c"
}]

Property	Definition
`values`	Provides the details of the event.
`_version`	The version of the event stream. The default value is 1.0.0.
`payload`	Defines the payload that was received.
`type`	The type of alert or event that was received.
`deviceIdentifier`	The Android device ID.
`id`	The ID of the respective event stream.