Создать отчет по задачам

Запрос позволяет создать отчет по задачам, который формируется на основе заданных критериев поиска задач.

https://api.tracker.yandex.net/v3/entities/report/

Формат запроса

Перед выполнением запроса получите доступ к API.

Для создания отчета используйте HTTP-запрос с методом POST. Тело запроса содержит параметры отчета и критерии для поиска задач.

POST /v3/entities/report/
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
  "fields": {
    "summary": "Выгрузка задач",
    "parameters": {
      "type": "issueFilterExport",
      "format": "xlsx",
      "filter": {
        "query": "Queue: SUPPORT \"Sort by\": Updated DESC",
        "sorts": [
          {
            "orderBy": "updated",
            "orderAsc": false
          }
        ]
      },
      "fields": [
        "priority",
        "type",
        "key",
        "summary",
        "assignee",
        "status",
        "updated"
      ]
    }
  }
}

Пример 1: Создание отчета с использованием языка запросов

• Отчет по задачам в формате XLSX.
• Отчет содержит задачи из очереди «SUPPORT».
• Результаты отсортированы по дате обновления в убывающем порядке.
• В отчет включены поля: приоритет, тип, ключ, название, исполнитель, статус, дата обновления.

POST /v3/entities/report/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID: 1234******

{
  "fields": {
    "summary": "Выгрузка задач очереди SUPPORT",
    "parameters": {
      "type": "issueFilterExport",
      "format": "xlsx",
      "filter": {
        "query": "Queue: SUPPORT \"Sort by\": Updated DESC",
        "sorts": [
          {
            "orderBy": "updated",
            "orderAsc": false
          }
        ]
      },
      "fields": [
        "priority",
        "type",
        "key",
        "summary",
        "assignee",
        "status",
        "updated"
      ]
    }
  }
}

Пример 2: Создание отчета с использованием объекта фильтрации

• Отчет по задачам в формате XLSX.
• Отчет формируется по параметрам: задачи из очереди «TREK», у которых нет исполнителя.
• В отчет включены основные поля задачи.

POST /v3/entities/report/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Cloud-Org-ID: ab1c******

{
  "fields": {
    "summary": "Задачи без исполнителя",
    "parameters": {
      "type": "issueFilterExport",
      "format": "xlsx",
      "filter": {
        "filter": {
          "queue": "TREK",
          "assignee": "empty()"
        }
      },
      "fields": [
        "key",
        "summary",
        "status",
        "priority",
        "created"
      ]
    }
  }
}

Пример 3: Создание отчета с использованием сохраненного фильтра

• Отчет по задачам в формате XLSX.
• Отчет создается на основе сохраненного фильтра с ID 12345.
• В отчет включены основные поля задачи.

POST /v3/entities/report/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID: 1234******

{
  "fields": {
    "summary": "Отчет по сохраненному фильтру",
    "parameters": {
      "type": "issueFilterExport",
      "format": "xlsx",
      "filter": {
        "filterId": 12345
      }
      "fields": [
        "key",
        "summary",
        "status",
        "assignee",
        "priority",
        "updated"
      ]
    }
  }
}

Формат ответа

{
    "self": "https://api.tracker.yandex.net/v3/entities/report/68f68b553cdc3969e0445570",
    "id": "68f68b553cdc3969e0445570",
    "version": 1,
    "shortId": 142,
    "entityType": "report",
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v3/users/8000000000000004",
        "id": "8000000000000004",
        "display": "Имя Фамилия",
        "cloudUid": "aje71i6t2tuvanuoimem",
        "passportUid": 1234567890
    },
    "createdAt": "2025-10-20T19:19:49.120+0000",
    "updatedAt": "2025-10-20T19:19:49.120+0000"
}