checkDictionaries

Сообщает о наличии изменений в справочнике регионов, часовых поясов и интересов к категориям мобильных приложений. Также используется для получения текущего серверного времени.

  1. Запрос
  2. Ответ
  3. Примеры

Запрос

Структура запроса в формате 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"
  }
}

Произошли изменения в справочнике часовых поясов.