Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
Description

Configure the Windows platform settings using this REST API. For more information on configuring the Windows platform settings via WSO2 EMM console, see Windows Platform Configurations.

Resource Path/
URL 
HTTP MethodPOST
Request/Response Formatapplication/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>
  • 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 includes the required properties to update the platform configurations the 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 f4c0c1b2b4ace7040132682139d51f74" -d @'configurations.json'-k -v https://localhost:9443
 Sample output
Code Block
 
Anchor
sampleUpdatePlatform
sampleUpdatePlatform
Sample JSON
Definition 
Code Block
{
  "type": "android",
  "configuration": [
    {
      "name": "notifierType",
      "value": "1",
      "contentType": "text"
    },
    {
      "name": "notifierFrequency",
      "value": "100000",
      "contentType": "text"
    },
    {
      "name": "windowsEula",
      "value": "License Agreement",
      "contentType": "text"
    }
  ]
} 
PropertyDescriptionValue
typeDefine the mobile platform.String
configurationDefines the configuration properties.String
nameProvide the configuration property name.String
contentTypeWhen passing the configuration details to the EMM registry the content type must be defined.String
value

Provide a value for the respective configuration property.

  • notifierType: If you wish to configure the Windows platform to communicate via local polling, assign 1 as the value.

  • notifierFrequency: Provide the notification frequency in milliseconds.

  • windowsEula: Provide the content for the license agreement that a user must accept when enrolling an Windows device with WSO2 EMM.

String