Получение истории изменения заявки
Копировать ссылку на статью
Задача
Получим жизненный цикл заявки с id = 4703096, который отсортирован по убыванию, первые 15 записей, в заданном промежутке дат.
Полная документация по API (swagger)
Решение
GET https://apigw.intradesk.ru/taskhistory/api/v2.0/lifetime/350913/full?ApiKey=65247DBDE14C45A6A275DC1FC0&sortDirection=Desc&top=15&dateStart=2020-01-19T09:20:19.7683830Z&dateEnd=2031-01-19T09:40:19.7683830Z
Ответ сервера:
{
"data": [
{
"id": 1055669, // идентификатор записи
"eventat": "2021-03-15T11:54:36.9286522Z", //дата события
"lifetimetype": 20, //тип события. 10 - заявка создана; 20 - заявка изменена; 30 - заявка эскалирована
"userid": 7387, // идентификатор пользователя, автора изменений
"username": "Иванова Настя", //имя пользователя, автора изменений
"events": {
"data": [
{
"isautomatic": false,
"blockname": "comment", //название блока заявки, в котором произошли изменения
"type": 50, //тип произошедшего на заявке события
"commentupdatedate": null,
"stringvalue": "В правой области карточки заявки появился скролл, причем он отображается наполовину. Его нужно либо скрыть совсем (как сейчас на Prod), либо отображать целиком", //поле для хранения измененного строкового значения
"datevalue": null, //поле для хранения измененного значения даты
"entityvalue": null, //поле для хранения измененного значения сложного типа, например, исполнителя заявки
"entitylanguagevalue": null,
"additionalfieldvalue": null
},
{
"isautomatic": false,
"blockname": "executor",
"type": 30,
"commentupdatedate": null,
"stringvalue": null,
"datevalue": null,
"entityvalue": {
"valuenew": {
"id": 8452,
"name": "Сидорин Иван"
},
"valueold": {
"id": 10037,
"name": "Крутов Кирилл"
}
},
"entitylanguagevalue": null,
"additionalfieldvalue": null
}
],
"count": 2
},
"correlationid": "e72ffca5-37d5-e35b-70a1-9d21c53dffee",
"uid": "be956567-45e9-4ce7-b4d4-b444df8e8e88"
},
{
"id": 1048384,
"eventat": "2021-03-11T12:41:30.3355437Z",
"lifetimetype": 20,
"userid": 0,
"username": "Система",
"events": {
"data": [
{
"isautomatic": false,
"blockname": "status",
"type": 10,
"commentupdatedate": null,
"stringvalue": null,
"datevalue": null,
"entityvalue": null,
"entitylanguagevalue": {
"valuenew": {
"id": 96,
"name": {
"ru": "ВыполнStage",
"en": null
}
},
"valueold": {
"id": 83,
"name": {
"ru": "ВыполнTest",
"en": null
}
}
},
"additionalfieldvalue": null
}
],
"count": 1
},
"correlationid": "9981080e-293a-4cd6-85fe-8e1eece66238",
"uid": "303f6bff-0726-4c45-99eb-23c9d051c5d5"
},
]
}
Полная документация к методу в формате swagger (TaskHistory API)
Другие возможные параметры
sortDirection - не обязательный; возможные значения Asc, Desc, по умолчанию Desc
top - не обязательный; по умолчанию 100
dateStart, dateEnd - не обязательны, используются для фильтрации по дате; если указаны, возвращают записи из истории с датой больше dateStart и меньше dateEnd