Page Comparison

Excerpt

Description

Get information, such as the device type, serial number, International Mobile Station Equipment Identity (IMEI), owner of the registered device, version and model, of the Android devices

Using this REST API you are able to request for Android device details. Once this REST API is executed it will be in the Android operation queue until the device calls the server to retrieve the list of operations that needs to be executed on the device.

For more information on the REST API command used by the device to get the pending operations queued up on the server end, see Getting Pending Android Device Operations.
For more information on getting the device details that the device sends back to the server, see Getting Details of an Android Device or Getting Details of a Device.

Resource Path /device-info

URL /mdm-android-agent/operation/device-info

HTTP Method POST

Request/Response Format application/json

cURL command

Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-android-agent/operation/device-info

For more information on how to generate the EMM API token, see Generating the OAuth 2.0 Access Token.
Define the path to the JSON file, which includes the required properties to carry out the operation, as the <JSON_PAYLOAD> value. For more information, see the Sample JSON Definition.
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.

Example:

Code Block
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer e56974e8bf5df15748f89c6c5da9835d" -d @'operation.json' -k -v https://localhost:9443/mdm-android-agent/operation/device-info
Note
Once this operation is invoked via the REST API, the user needs to refresh the device management page in the EMM console to see the latest device information. For more information, see Viewing Device Specific Information.

Sample output

Code Block

> POST /mdm-android-agent/operation/device-info HTTP/1.1
> User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8| zlib/1.2.5
> Host: localhost:9443
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer e56974e8bf5df15748f89c6c5da9835d
> Content-Length: 21
< HTTP/1.1 201 Created
< Date: Wed, 10 Jun 2015 09:42:18 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server

Anchor

	sampleGetInfo
	sampleGetInfo

Sample JSON Definition

Code Block
[ "d8:50:e6:2f:6a:8b", "a5:60:e6:2g:6a:5b" ]

Property Value	Description	Data Type
`deviceIDS`	ID of the Android device. Multiple device IDs can be added by using comma separated values. For more information on retrieving the device ID, see Retrieving the ID of an Android device.	String

Versions Compared

Old Version 5

New Version Current

Key