---

VirtualRef/API/Get - получение вопросов

---

НАЧАЛО >> Виртуальная справка >> API виртуальной справки >> VirtualRef/API/Get - получение вопросов📄 Скачать в DOCX

---

Функция VirtualRef/API/Get возвращает обращения виртуальной справки, измененные начиная с указанной метки времени. Ее используют внешние личные кабинеты и справочные системы, чтобы синхронизировать список вопросов и состояние ответов.

Вызов:

UseModule('VirtualRef')->API_Get(
    int $datetime = 0,
    string $userId = ''
): VirtialRef_API_Get

1. Параметры

Параметр	Тип	Обязательный	Описание
datetime	int	нет	Метка времени Unix time. Функция возвращает вопросы, измененные начиная с этой метки. Если параметр равен 0, выборка начинается с минимальной даты.
userId	string	нет	Идентификатор пользователя внешней системы. Если заполнен, функция возвращает только вопросы этого пользователя.

2. Как выбираются записи

Если userId не указан, функция читает термины VRTM= в системной базе I128F, начиная с даты и времени, рассчитанных по параметру datetime, и возвращает найденные записи VirtualRef.

Если userId указан, функция сначала ищет вопросы пользователя по префиксу questionInLK=, затем оставляет только записи, у которых время последнего изменения больше или равно datetime.

3. Результат

Функция возвращает объект VirtialRef_API_Get. Структура результата описана в разделе class VirtialRef_API_Get.

Основной массив ответа - refs_data. Каждый элемент соответствует одному вопросу и содержит:

• SID записи вопроса;
• внешний идентификатор вопроса;
• время создания и последнего изменения;
• текстовый и числовой статус;
• идентификатор пользователя;
• текст вопроса и ответа;
• признаки публикации и скрытия;
• дополнительные поля интеграции, включая телефон для связи;
• веб-ссылки, библиографические описания, ссылки на записи электронного каталога и вложения.

Если при чтении терминов, поиске или чтении записи возникает ошибка, выполнение завершается сообщением об ошибке с кодом ошибки IRBIS.