Ringing iOS Devices

Overview

Description	If you misplaced your iOS device and need to find out if its around, you can ring the device using this REST API.
Resource Path	`/ring`
URL	`/ios/operation/ring`
HTTP Method	`POST`
Request/Response Format	`application/json`

Sample request

[
  "2be702beaaf4ad34fc9e7f8da2b6b808c453fa72b", 
  "2ec33430ad456713c633de75b2219376bac45de56"
]

For information on the property definitions, see Resource Definition for Common iOS Operations.

cURL command

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>/ios/operation/ring

For more information on how to generate the EMM API token, see Generating the EMM API Token.
Define the path to the JSON file, which lists the devices and the applications, as the <JSON_PAYLOAD> value.
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: device_id.json has the device ID's listed as shown under sample request.

curl -X POST -H "Content-Type: application/json" -H "Authorization: 33392fb365b3ac693b405b565ddc8a3a" -d @'device_id.json' -k -v https://localhost:9443/ios/operation/ring

Sample output

> POST /ios/operation/ring HTTP/1.1
> Host: 127.0.0.1:9443
> User-Agent: curl/7.43.0
> Content-Type: application/json
> Accept: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
> Content-Length: 44
< HTTP/1.1 201 Created
< Date: Thu, 18 Feb 2016 08:33:47 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server