checkDictionaries
Сообщает о наличии изменений в справочнике регионов, часовых поясов и интересов к категориям мобильных приложений. Также используется для получения текущего серверного времени.
Запрос
Структура запроса в формате JSON:
{
"method": "checkDictionaries",
"params": {
"Timestamp": (string)
}
}
Параметр | Тип | Описание | Обяза-тельный |
Структура params (для JSON) / CheckDictionariesRequest (для SOAP) | |||
---|---|---|---|
Timestamp | string | Момент времени, начиная с которого проверяются изменения. Указывается в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601), например 2015-05-24T23:59:59Z . Если метод вызван без параметра Timestamp, возвращается только текущее время на сервере. | Нет |
Параметр | Тип | Описание | Обяза-тельный |
Структура params (для JSON) / CheckDictionariesRequest (для SOAP) | |||
---|---|---|---|
Timestamp | string | Момент времени, начиная с которого проверяются изменения. Указывается в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601), например 2015-05-24T23:59:59Z . Если метод вызван без параметра Timestamp, возвращается только текущее время на сервере. | Нет |
Ответ
Структура ответа в формате JSON:
{
"result": { /* result */
"TimeZonesChanged": ( "YES" | "NO" ),
"RegionsChanged": ( "YES" | "NO" ),
"InterestsChanged": ( "YES" | "NO" ),
"Timestamp": (string) /* required */
}
}
Параметр | Тип | Описание |
Структура result (для JSON) / CheckDictionariesResponse (для SOAP) | ||
---|---|---|
TimeZonesChanged | YesNoEnum | Показывает наличие или отсутствие изменений в справочнике часовых поясов — YES/NO. Присутствует в ответе, если при вызове метода задан параметр Timestamp. |
RegionsChanged | YesNoEnum | Показывает наличие или отсутствие изменений в справочнике регионов — YES/NO. Присутствует в ответе, если при вызове метода задан параметр Timestamp. |
InterestsChanged | YesNoEnum | Показывает наличие или отсутствие изменений в справочнике интересов к категориям мобильных приложений — YES/NO. Присутствует в ответе, если при вызове метода задан параметр Timestamp. |
Timestamp | string | Момент времени, когда выполнялась проверка изменений. Выводится в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601), например 2015-05-24T23:59:59Z . Это время указывают при следующем вызове метода, чтобы проверять изменения начиная с этого момента. |
Параметр | Тип | Описание |
Структура result (для JSON) / CheckDictionariesResponse (для SOAP) | ||
---|---|---|
TimeZonesChanged | YesNoEnum | Показывает наличие или отсутствие изменений в справочнике часовых поясов — YES/NO. Присутствует в ответе, если при вызове метода задан параметр Timestamp. |
RegionsChanged | YesNoEnum | Показывает наличие или отсутствие изменений в справочнике регионов — YES/NO. Присутствует в ответе, если при вызове метода задан параметр Timestamp. |
InterestsChanged | YesNoEnum | Показывает наличие или отсутствие изменений в справочнике интересов к категориям мобильных приложений — YES/NO. Присутствует в ответе, если при вызове метода задан параметр Timestamp. |
Timestamp | string | Момент времени, когда выполнялась проверка изменений. Выводится в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601), например 2015-05-24T23:59:59Z . Это время указывают при следующем вызове метода, чтобы проверять изменения начиная с этого момента. |
Примеры
- Запрос текущего серверного времени
-
{ "method": "checkDictionaries", "params": {} }
- Ответ
-
{ "result": { "Timestamp": "2015-02-02T10:08:22Z" } }
- Проверка наличия изменений в справочниках, начиная с 02.02.2015 10:08:22 UTC
-
{ "method": "checkDictionaries", "params": { "Timestamp": "2015-02-02T10:08:22Z" } }
- Ответ
-
{ "result": { "TimeZonesChanged": "YES", "RegionsChanged": "NO", "Timestamp": "2015-02-02T12:24:31Z" } }
Произошли изменения в справочнике часовых поясов.