checkDictionaries

Shows whether there are any changes in the reference lists of regions, time zones, and mobile app categories. You can also use it to get the current time on the server.

  1. Request
  2. Response
  3. Examples

Request

Request structure in JSON format:

{
  "method": "checkDictionaries",
  "params": {
    "Timestamp": (string)
  }
}
ParameterTypeDescriptionRequired
Params structure (for JSON) / CheckDictionariesRequest structure (for SOAP)
TimestampstringThe exact time to start from to check for changes. Specified in the format YYYY-MM-DDThh:mm:ssZ (conforming to ISO 8601), such as 2015-05-24T23:59:59Z. If the method is called without the Timestamp parameter, it returns only the current time on the server.No

Response

Response structure in JSON format:

{
  "result": { /* result */
    "TimeZonesChanged": ( "YES" | "NO" ),
    "RegionsChanged": ( "YES" | "NO" ),
    "InterestsChanged": ( "YES" | "NO" ),
    "Timestamp": (string) /* required */
  }
}
ParameterTypeDescription
Result structure (for JSON) / CheckDictionariesResponse structure (for SOAP)
TimeZonesChangedYesNoEnum

Shows whether or not there are any changes in the time zone reference list — YES/NO.

Present in the response if the Timestamp parameter was included in the method call.

RegionsChangedYesNoEnum

Shows whether or not there are any changes in the region reference list — YES/NO.

Present in the response if the Timestamp parameter was included in the method call.

InterestsChangedYesNoEnum

Shows whether or not there are any changes in the reference list of mobile app categories — YES/NO.

Present in the response if the Timestamp parameter was included in the method call.

TimestampstringThe exact time when changes were checked. Specified in the format YYYY-MM-DDThh:mm:ssZ (conforming to ISO 8601), such as 2015-05-24T23:59:59Z. The timestamp is specified in the next method call, to check for changes starting from this time.

Examples

Request for the current server time
{
  "method": "checkDictionaries",
  "params": {}
}
Response
{
  "result": {
    "Timestamp": "2015-02-02T10:08:22Z"
  }
}
Checking for changes in the reference lists starting from 02.02.2015 10:08:22 UTC
{
  "method": "checkDictionaries",
  "params": {
    "Timestamp": "2015-02-02T10:08:22Z"
  }
}
Response
{
  "result": {
    "TimeZonesChanged": "YES",
    "RegionsChanged": "NO",
    "Timestamp": "2015-02-02T12:24:31Z"
  }
}

Changes have been made in the time zone reference list.