Задача
Получим жизненный цикл заявки с id = 4703096, который отсортирован по убыванию, первые 15 записей, в заданном промежутке дат, а события, произошедшие на заявке: добавление комментария (50), смена исполнителя (30) или смена статуса (10)
Решение
Ответ сервера:
{
"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
events - тип произошедшего на заявке события, возможно несколько значений через амперсанд. По умолчанию - все.
Доступные события для фильтрации:
ChangeStatus = 10,
ChangePriority = 20,
ChangeRating = 25,
ChangeExecutor = 30,
ChangeExecutorGroup = 40,
ChangeAdditionalData = 45,
AddComment = 50,
AddPrivateComment = 55,
AddObserver = 60,
AddCoordinator = 61,
AddObserverGroup = 65,
DeleteObserver = 70,
DeleteObserverGroup = 75,
AddFile = 80,
AddPrivateFile = 85,
DeleteFile = 90,
DeletePrivateFile = 95,
AddTag = 100,
AddAsset = 105,
DeleteTag = 110,
DeleteAsset = 115,
ChangeResolutionDatePlan = 120,
ChangeResolutionDateFact = 125,
ChangeResolutionLeftMinutes = 126,
ChangeReactionDatePlan = 130,
ChangeReactionDateFact = 135,
ResolutionTimeExpired = 136,
ReactionTimeExpired = 137,
ChangeClosedAt = 138,
ChangeService = 140,
ChangeTaskType = 150,
ChangeInitiator = 160,
ChangeClientId = 161,
ChangeInitiatorGroup = 165,
ChangeAdditionalField = 170,
ChangeCreatedAt = 180,
ChangeUpdatedAt = 185,
ChangeCreatedBy = 190,
ChangeUpdatedBy = 195,
ChangeName = 200,
ChangeDescription = 205,
ChangeWorkflow = 210,
AddExecutorNot = 220,
AddExecutorNotGroup = 225,
DeleteExecutorNot = 230,
DeleteExecutorNotGroup = 235,
ChangeSla=240,
ChangeLifetime = 250,
ChangeCreatedChannel = 260,
ChangeUpdatedChannel = 270,
Archive = 280,
AddedCoordinates = 290,
ExecutedMacrosOnTask = 300,
ChangeIsMassIncidentActive = 310,
ChangeMassIncident = 320,
ChangeCoordination = 330,
ChangePriorityCriticality = 340,
ChangePriorityInfluence = 350,
TaskEscalation = 400