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)
  }
}
Parameter Type Description Required
Params structure (for JSON) / CheckDictionariesRequest structure (for SOAP)
Timestamp string The exact time to start from to check for changes. Specified in YYYY-MM-DDThh:mm:ssZ format (conforming to ISO 8601), such as 2015-05-24T23:59:59Z. If the method is called without the Timestamp parameter, it only returns the current time on the server. No
Parameter Type Description Required
Params structure (for JSON) / CheckDictionariesRequest structure (for SOAP)
Timestamp string The exact time to start from to check for changes. Specified in YYYY-MM-DDThh:mm:ssZ format (conforming to ISO 8601), such as 2015-05-24T23:59:59Z. If the method is called without the Timestamp parameter, it only returns 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 */
  }
}
Parameter Type Description
Result structure (for JSON) / CheckDictionariesResponse structure (for SOAP)
TimeZonesChanged YesNoEnum

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.

RegionsChanged YesNoEnum

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.

InterestsChanged YesNoEnum

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.

Timestamp string The exact time when changes were checked. Specified in YYYY-MM-DDThh:mm:ssZ format (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.
Parameter Type Description
Result structure (for JSON) / CheckDictionariesResponse structure (for SOAP)
TimeZonesChanged YesNoEnum

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.

RegionsChanged YesNoEnum

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.

InterestsChanged YesNoEnum

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.

Timestamp string The exact time when changes were checked. Specified in YYYY-MM-DDThh:mm:ssZ format (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.