--- metadata: - name: generator content: Diplodoc Platform v5.66.1 - property: og:type content: article - property: article:section content: Справочник API - property: og:title content: Параметры задач в запросах к API и ответах - property: article:tag content: Техническая инструкция alternate: - https://yandex.ru/support/tracker/en/api/issues/fields.md - https://yandex.ru/support/tracker/ru/api/issues/fields.md - href: https://yandex.ru/support/tracker/ru/api/issues/fields.md type: text/markdown title: Markdown version - href: https://yandex.ru/support/tracker/ru/llms.txt?revision=r22057024 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt?revision=r22057024 # Параметры задач в запросах к API и ответах При работе с задачами через API вы можете использовать различные параметры для создания, редактирования и получения информации о задачах. В этой документации описаны стандартные параметры задачи, которые доступны в Трекере по умолчанию, а также стандартные объекты, которые могут содержаться в задаче: * [Параметры задачи в запросах к API](https://yandex.ru/support/tracker/ru/api/issues/request-fields.md) * [Параметры задачи в ответах на запросы](https://yandex.ru/support/tracker/ru/api/issues/response-fields.md) Помимо стандартных параметров, задачи могут содержать: - Пользовательские глобальные поля, созданные в организации. - Локальные поля, специфичные для конкретной очереди. ### Глобальные поля {#global} Глобальные поля можно использовать в задачах во всех очередях Трекера. По умолчанию в Трекере доступны самые популярные поля задач. Дополнительные глобальные поля может создать администратор Трекера. [Как добавить в Трекер глобальное поле](https://yandex.ru/support/tracker/user/create-param.html#global-field). Список всех глобальных полей можно посмотреть на странице [Настройки Трекера](https://tracker.yandex.ru/admin/fields). ### Локальные поля {#local} Локальное поле можно использовать только в задачах той очереди, к которой оно привязано. Преимущество локальных полей в том, что владелец очереди может управлять такими полями без риска повлиять на процессы работы в других очередях. Пользователи, которые работают в других очередях, не будут видеть это поле в своих задачах. Как использовать локальные поля, читайте в разделе [Локальные поля задач](https://yandex.ru/support/tracker/local-fields.html). #### Как использовать локальные поля в API {#use-local-fields} - Идентификатор локального поля включает шестнадцатеричный префикс и ключ поля: `603fb94c38bbe658********--myfield`. Например, чтобы изменить значение локального поля задачи через API, в теле HTTP-запроса на редактирование задачи укажите идентификатор поля: `603fb94c38bbe658********--КЛЮЧ_ПОЛЯ: "НОВОЕ_ЗНАЧЕНИЕ_ЛОКАЛЬНОГО_ПОЛЯ"`. [Как редактировать задачу с помощью API](https://yandex.ru/support/tracker/ru/api/issues/patch-issue.md) - Убедитесь, что локальное поле принадлежит указанной очереди. - Соблюдайте типы данных согласно схеме поля: - Для строковых полей используйте строки - Для числовых полей используйте числа - Для массивов пользователей используйте объекты с полем `id` - Чтобы получить список локальных полей очереди, используйте запрос [Получить список локальных полей очереди](https://yandex.ru/support/tracker/ru/api/queues/get-local-fields.md) #### Форматы значений локальных полей {#local-values} Формат значения в теле запроса на [создание](https://yandex.ru/support/tracker/ru/api/issues/create-issue.md) и [редактирование](https://yandex.ru/support/tracker/ru/api/issues/patch-issue.md) задачи зависит от типа поля и может отличаться от отображения и ввода в интерфейсе Трекера. Формат значения в ответе API тоже может отличаться от формата в запросе, поэтому он указан отдельно. Названия классов типов для запросов к API перечислены в разделе [Параметры тела запроса](https://yandex.ru/support/tracker/ru/api/queues/create-local-field.md#query) запроса на создание локального поля. #| || **Тип поля** | **Значение в запросе** | **Значение в ответе** || || Текстовое однострочное и многострочное поле | Строка: `"Текстовое значение"` | Строка || || Целое число | Число: `42` | Число: `42` || || Дробное число | Число: `0.75` | Число: `0.75` || || Ссылка | Строка с абсолютным URL и схемой: `"https://example.com"` | Строка || || Дата | Строка ISO 8601: `"2026-11-01"` | Строка в формате `ГГГГ-ММ-ДД` || || Дата и время | Строка ISO 8601 с датой, временем и часовым поясом | Строка ISO 8601 со смещением часового пояса || || Пользователь | Логин строкой или объект с полем `login` либо `id`: `"user1"`, `{"login": "user1"}` | Объект с данными пользователя || || Продолжительность | Строка ISO 8601: `"P1W2D"`. [Подробнее](#duration-values) | Строка в том же формате || || Деньги | Число, строка или объект. [Подробнее](#money-values) | Объект с полями `unit` и `amount` || || Деньги и ставка | Число или объект. [Подробнее](#money-rate-values) | Объект с полями `unit`, `amount` и `rate` || |# Если в значении типа «Дата» указать время, оно не учитывается. Для типа «Дата и время» передайте, например, `"2026-11-01T12:30:00.000+03:00"`. **Несколько значений.** Для полей, в которых разрешено несколько значений (параметр `container` при [создании поля](https://yandex.ru/support/tracker/ru/api/queues/create-local-field.md#query)), передайте массив элементов того же формата: `["user1", "user2"]`. При редактировании задачи для такого поля можно использовать операторы `set`, `add`, `remove` — [подробнее](https://yandex.ru/support/tracker/ru/api/issues/patch-issue.md#req-body-params). Значение `null` очищает поле. **Выпадающий список.** В поле передается значение из списка `values`, заданного при [создании поля](https://yandex.ru/support/tracker/ru/api/queues/create-local-field.md#query). Для списка с множественным выбором передайте массив таких значений. Пример тела запроса с полями типов, которых нет в примерах [создания](https://yandex.ru/support/tracker/ru/api/issues/create-issue.md) и [редактирования](https://yandex.ru/support/tracker/ru/api/issues/patch-issue.md) задачи: ```json translate=no { "603fb94c38bbe658********--durationField": "P1W2D", "603fb94c38bbe658********--moneyField": {"code": "USD", "amount": 12.34}, "603fb94c38bbe658********--dateField": "2026-11-01", "603fb94c38bbe658********--dateTimeField": "2026-11-01T12:30:00.000+03:00" } ``` ##### Продолжительность {#duration-values} Передайте строку в формате ISO 8601 `PnWnDTnHnMnS`: недели (`W`), дни (`D`), часы (`H`), минуты (`M`) и секунды (`S`). Любую часть можно опустить, недели и дни можно указывать вместе. Например, `"P1W2D"` или `"PT1H30M"`. Недели и дни считаются по рабочему календарю: неделя — 5 рабочих дней, день — 8 часов. Годы и месяцы указать нельзя. В ответе API значение возвращается строкой в том же формате. ##### Деньги {#money-values} В запросе можно передать: - Число — сумму в валюте по умолчанию: `12.34` - Строку с кодом валюты и суммой: `"USD 12.34"` - Объект с полем `amount` (сумма) и полем `code` (код валюты по ISO 4217) либо `country` (код страны) Сумма округляется до минимальной единицы валюты: `12.3456` → `12.35` для USD. Пример значения в запросе: ```json translate=no {"code": "USD", "amount": 12.34} ``` В ответе код валюты находится в поле `unit`, а сумма возвращается строкой: ```json translate=no {"unit": "USD", "amount": "12.34"} ``` ##### Деньги и ставка {#money-rate-values} Передайте число или объект с теми же полями, что у типа «Деньги», и полем `rate` (ставка). Если ставку не указать, применяется значение по умолчанию. Сумма сохраняется без округления. Пример значения в запросе: ```json translate=no {"code": "USD", "amount": 12.34, "rate": 0.5} ``` В ответе код валюты находится в поле `unit`, а значения `amount` и `rate` возвращаются строками: ```json translate=no {"unit": "USD", "amount": "12.34", "rate": "0.5"} ```