Получить список заявок
GET /tickets/
Пример URL
https://домен_системы/api/v2/tickets/?page=1&search=John Doe
Query-параметры
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
page | число | Нет | Номер страницы (на странице показывается 30 заявок) |
search | строка | Нет | Поиск |
exact_search | число | Нет | Поиск по полному совпадению значения "search" (0 - полное совпадение, 1 стандартный поиск) |
user_list | строка | Нет | Поиск заявок по ID владельца (ID указываются через запятую) |
owner_list | строка | Нет | Поиск заявок по ID исполнителя заявки (ID указываются через запятую) |
status_list | строка | Нет | Поиск заявок по ID статуса заявки (ID указываются через запятую) |
priority_list | строка | Нет | Поиск заявок по ID приоритета заявки (ID указываются через запятую) |
type_list | строка | Нет | Поиск заявок по ID типа заявки (ID указываются через запятую) |
freeze | число | Нет | Фильтр по замороженным заявкам (1 - только замороженные заявки, 0 - все заявки, по умолчанию) |
deleted | число | Нет | Фильтр по удалённым заявкам (1 - только удалённые заявки, 0 - все заявки, по умолчанию) |
from_date_created | строка | Нет | Дата создания "от". Заявки, созданные с указанного момента (гггг-мм-дд чч:мм:сс) |
to_date_created | строка | Нет | Дата создания "до". Заявки, созданные до указанного момента (гггг-мм-дд чч:мм:сс) |
from_date_updated | строка | Нет | Дата изменения "от". Заявки, в которых были изменения с указанного момента (гггг-мм-дд чч:мм:сс) |
to_date_updated | строка | Нет | Дата изменения "до". Заявки, в которых были изменения до указанного момента (гггг-мм-дд чч:мм:сс) |
order_by | строка | Нет | Сортировка заявок, через запятую. Доступны параметры: date_created, date_updated, viewed_by_staff, viewed_by_client. Порядок сортировки: {asc} - по возрастанию и {desc} - по убыванию; Значение по умолчанию - date_created{desc} |
Пример ответа
{
"data": {
"1": {
"id": 1,
"pid": 2,
"unique_id": "TXS-23187",
"date_created": "2025-03-10 11:34:58",
"date_updated": "2025-03-10 11:34:58",
"title": "Тема заявки",
"source": "system",
"status_id": "open",
"priority_id": 2,
"type_id": 0,
"department_id": 1,
"department_name": "Отдел поддержки",
"owner_id": 0,
"owner_name": "",
"owner_lastname": "",
"owner_name": "Staff",
"owner_lastname": "",
"owner_email": "[email protected]",
"user_id": 1,
"user_name": "Client",
"user_lastname": "",
"user_email": "[email protected]",
"cc": [],
"bcc": [],
"followers": [],
"ticket_lock": 0,
"sla_date": "10.03.2025 11:35",
"sla_flag": 0,
"freeze_date": null,
"freeze": 0,
"viewed_by_staff": 1,
"viewed_by_client": 0,
"rate": "",
"rate_comment": "",
"rate_date": "",
"deleted": 0,
"custom_fields": [],
"tags": [],
"jira_issues": []
},
"2": {
"id": 2,
"pid": 0,
"unique_id": "WMK-86670",
"date_created": "2025-03-10 11:34:13",
"date_updated": "2025-03-10 11:34:29",
"title": "mpghtestd",
"source": "system",
"status_id": "open",
"priority_id": 2,
"type_id": 0,
"department_id": 1,
"department_name": "Отдел поддержки",
"owner_id": 0,
"owner_name": "",
"owner_lastname": "",
"owner_name": "Staff",
"owner_lastname": "",
"owner_email": "[email protected]",
"user_id": 1,
"user_name": "Client",
"user_lastname": "",
"user_email": "[email protected]",
"cc": [],
"bcc": [],
"followers": [],
"ticket_lock": 0,
"sla_date": "10.03.2025 11:35",
"sla_flag": 0,
"freeze_date": null,
"freeze": 0,
"viewed_by_staff": 1,
"viewed_by_client": 0,
"rate": "",
"rate_comment": "",
"rate_date": "",
"deleted": 0,
"custom_fields": [],
"tags": [],
"jira_issues": []
}
},
"pagination": {
"total": 2,
"per_page": 30,
"current_page": 1,
"total_pages": 1
}
}
Внимание
Информация о некоторых параметрах заявок, возвращаемая методами GET /tickets/
и GET /tickets/:ticket_id/
, может различаться.
Рекомендуется использовать метод GET /tickets/:ticket_id/
, если требуется получить наиболее актуальные данные по конкретной заявке.
Метод GET /tickets/
использует индексированные данные, обновление которых может происходить с задержкой.