Описание: Получить относительный URL страницы портала, на которой отображается элемент замечания (issue) или элемент, связанный с замечанием через ссылку-замечание (issue reference) — например, для перехода из письма-оповещения или внешней интеграции сразу на нужный элемент/представление.
Логика формирования ссылки:
- Если элемент сам является замечанием (или его потомком по типу контента) — сначала ищется связанная ссылка-замечание (issue reference) на него; если найдена — URL строится по элементу назначения этой ссылки, иначе — по самому элементу как задаче списка ЦА "Задачи" (
/site/{siteId}/list/{listId}/item/{itemId}). - Если элемент сам является ссылкой-замечанием — URL строится по элементу назначения (
Destination) этой ссылки. - В остальных случаях URL строится по самому переданному элементу.
- При построении ссылки на задачу дополнительно подбирается представление списка ЦА "Задачи", отфильтрованное по функции "Замечания" (feature), если такое представление настроено — тогда ссылка ведёт сразу в это представление.
🌐 HTTP-информация
- Метод:
POST - URL:
/issues/api/issue/GetDisplayUrl/{itemId} - Headers:
Authorization: <UserSessionToken>
📥 Параметры запроса (URL Path)
| Параметр | Тип | Описание |
|---|---|---|
itemId | Guid | ID элемента (замечания, ссылки-замечания или произвольного элемента). |
📦 Тело запроса (Request Body)
Метод не принимает тела запроса.
📤 Тело ответа (Response Body)
Строка с относительным URL (например: /site/{siteId}/list/{listId}/item/{itemId} или /site/{siteId}/list/{listId}/view/{viewId}/item/{itemId}?treeList={listId}).