Мобильное приложение
REST API
Тестирование

Получение заявки

Сущность.Метод: request.get

Метод возвращает заявку, её чеклист, дополнительные поля и действия, доступные текущему пользователю.

Нужна авторизация. Заявка должна быть видна текущему пользователю — по тем же правилам, что и в request.list. Если заявку открыл не её автор, просмотр записывается, и viewers_count в ответе уже учитывает этот просмотр.

Параметры запроса

КлючОписаниеОбяз.
idИД заявкиДа

Пример:

{
  "id": 15
}

Параметры ответа

КлючОписаниеОбяз.
requestЗаявка. Набор полей совпадает с элементом items метода request.listДа
checklistПункты чеклистаДа
permissionsКоды действий, доступных текущему пользователюДа
need_start_by_nfctrue — у заявки есть оборудование, и начать работу по нему можно после сканирования NFC-меткиДа
fieldsДополнительные поля типа заявкиДа
subscribedtrue — текущий пользователь подписан на заявку либо получает уведомления по её типуДа

Соисполнители (request.co_executors)

КлючОписание
idИД записи соисполнителя
user_idИД пользователя
user_nameИмя
user_last_nameФамилия

Пункт чеклиста (checklist)

КлючОписание
idИД пункта
request_idИД заявки
nameНазвание
typeTEXT, PHOTO, NUMBER или CHECKBOX
valueЗначение. Для PHOTO — массив файлов: id, name, src, image, video, а для изображения ещё preview, full, width, height
optionsДополнительные настройки пункта
statusN — пункт не выполнен, Y — выполнен
codeСимвольный код

Действия (permissions)

В массив попадают только те коды, которые сейчас доступны.

КлючОписание
editРедактировать заявку
takeНазначить себя исполнителем
delegateСменить исполнителя
startНачать выполнение
stopОстановить выполнение
completeЗавершить заявку
checklistЗаполнять чеклист
reopenВернуть заявку в работу
rateОценить заявку
deadlineУстановить крайний срок
worksРедактировать выполненные работы
works_factorРедактировать коэффициенты работ
coordinationДобавлять согласование
sla_level_changeМенять уровень SLA

Дополнительное поле (fields)

КлючОписание
codeКод поля
nameНазвание
typeSTRING, TEXTAREA, NUMBER, LIST, DATE или FILE
requiredY — поле обязательное
multipleY — несколько значений
valueСохранённое значение
display_valueЗначение для показа
settingsНастройки поля

Ошибки

  • PARAMS_ERROR — не передан id
  • NOT_FOUND — заявка не найдена или недоступна