Event Publishing API Guide
This section provides the details of the REST APIs used to publish and get details of events received by the WSO2 EMM Android client.
Publishing Events
Description | Publish events revceived by the WSO2 EMM Android client to WSO2 DAS using this API. | ||||||||
---|---|---|---|---|---|---|---|---|---|
Resource Path | / | ||||||||
URL | /mdm-android-agent/events/ | ||||||||
HTTP Method | POST | ||||||||
Request/Response Format | application/json | ||||||||
cURL command | curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -d @'<JSON_PAYLOAD>' -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-android-agent/events/
Example: curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer d869e4c177f17143748376d54633473" -k -d @'event.json' -v https://localhose:9443/mdm-android-agent/events/ | ||||||||
Sample output | > POST /mdm-android-agent/events/ HTTP/1.1 > Host: localhost:9443 > User-Agent: curl/7.43.0 > Accept: */* > Authorization: Bearer 988f0b0688dce337cd64dfeb899f4cb1 > Content-Type: application/json > Cache-Control: no-cache > Content-Length: 154 < HTTP/1.1 201 Created < Date: Sun, 01 May 2016 08:40:58 GMT < Content-Type: application/json < Content-Length: 51 < Server: WSO2 Carbon Server {"responseCode":"Event is published successfully."} | ||||||||
Sample JSON Definition | { "deviceIdentifier":"353863072233137", "payload":"{\"packageName\":\"org.wso2.emm.agent\",\"state\":\"removed\"}", "type":"APPLICATION_STATE" }
|
Getting Event Details of a device
Description | Get the event details received by an Android device using this API. | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Resource Path |
| ||||||||||||||
URL | mdm-android-agent/events/{deviceIdentifier} | ||||||||||||||
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}
Example: Retrieve event details that corresponds to the Android device having the curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer d869e4c177f17143748376d54633473"-k -v https://localhose:9443/mdm-android-agent/events/359298055243973 | ||||||||||||||
Sample output | > GET /mdm-android-agent/events/352317052330505 HTTP/1.1 > Host: localhost:9443 > User-Agent: curl/7.43.0 > Accept: */* > Content-Type: application/json > Authorization: Bearer ee189258cea79c86d7656235f30e231d > < HTTP/1.1 200 OK < Date: Sun, 01 May 2016 05:31:07 GMT < Content-Type: application/json < Content-Length: 476 < 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"},{"values":{"_version":"1.0.0","payload":"{\"packageName\":\"system_server\",\"cpu\":11,\"pid\":2436,\"pss\":0,\"sharedDirty\":0,\"uss\":0}","type":"RUNTIME_STATE", "deviceIdentifier":"352317052330505"},"id":"b65a65c5-23f9-3258-83be-1745f4d8e0ae"}] | ||||||||||||||
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" }, { "values":{ "_version":"1.0.0", "payload":"{\"packageName\":\"system_server\",\"cpu\":11,\"pid\":2436,\"pss\":0,\"sharedDirty\":0,\"uss\":0}", "type":"RUNTIME_STATE", "deviceIdentifier":"352317052330505" }, "id":"b65a65c5-23f9-3258-83be-1745f4d8e0ae" } ]
|
Getting Event Details for a Given Time Period
Description | Get the event details of a device for a given time duration using this API. | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Resource Path | /{deviceIdentifier/date?from={unixTimestamp}&to={unixTimestamp) | ||||||||||||||
URL | /mdm-android-agent/events/{deviceIdentifier}/date?from={unixTimestamp}&to={unixTimestamp} | ||||||||||||||
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}/date?from={unixTimestamp}&to={unixTimestamp}
Example: Retrieve event details that corresponds to the Android device where the device identifier is curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer 5747a79c4ec8d7445aa622463031d299" -k -vhttp://localhost:9443/mdm-android-agent/events/352317052330505/date?from=1462108907&to=1462108930 | ||||||||||||||
Sample output | > GET /mdm-android-agent/events/352317052330505/date?from=1462108907&to=1462108930 HTTP/1.1 > Host: localhost:9443 > User-Agent: curl/7.43.0 > Accept: */* > Content-Type: application/json > Authorization: Bearer ee189258cea79c86d7656235f30e231d > < HTTP/1.1 200 OK < Date: Sun, 01 May 2016 05:55:56 GMT < Content-Type: application/json < Content-Length: 476 < 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"},{"values":{"_version":"1.0.0","payload":"{\"packageName\":\"system_server\",\"cpu\":11,\"pid\":2436,\"pss\":0,\"sharedDirty\":0,\"uss\":0}","type":"RUNTIME_STATE", "deviceIdentifier":"352317052330505"},"id":"b65a65c5-23f9-3258-83be-1745f4d8e0ae"}] | ||||||||||||||
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" }, { "values": { "_version": "1.0.0", "payload": "{\"packageName\":\"system_server\",\"cpu\":11,\"pid\":2436,\"pss\":0,\"sharedDirty\":0,\"uss\":0}", "type": "RUNTIME_STATE", "deviceIdentifier": "352317052330505" }, "id": "b65a65c5-23f9-3258-83be-1745f4d8e0ae" }]
|
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 |
| ||||||||||||||
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}
Example: Retrieve event details that corresponds to the Android device having the 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" }]
|