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.
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.