ipr.ipr.get

Scope: ipr

Кто может вызывать: Авторизованный пользователь с доступом к карточке (стандартный ACL инфоблока Bitrix). Подробнее: Роли и права доступа

Возвращает карточку ИПР/ПИС по ID вместе со списком привязанных компетенций и мероприятий.

HTTP: GET

Побочные эффекты: none

Параметры метода

Параметр Тип Обяз. Описание
id int да ID карточки

Возвращаемые данные

Поле Тип Описание
id int ID карточки
title string Название
active bool ACTIVE = Y
userId int Сотрудник
managerId int Руководитель
status string XML_ID статуса, см. ipr.ipr.status.list
deadline string|null Плановая дата завершения, YYYY-MM-DD
startFact string|null Фактическая дата начала
finishFact string|null Фактическая дата завершения
type string XML_ID типа: IPR | PIS
period string XML_ID/значение периода (месяцы)
targetPositionId int Целевая должность
observers int[] ID наблюдателей карточки
nextTemplateId int Шаблон следующей программы (если задан)
canEdit bool Разрешено ли изменение карточки текущему пользователю (false для FINISHED)
canDelete bool Разрешено ли удаление (false для FINISHED)
competencies array Компетенции карточки, см. ниже
dateCreate string Дата создания
timestampX string Дата последнего изменения

Структура competencies[]

Поле Тип Описание
id int ID компетенции в составе ИПР (используется как iprCompetencyId в методах мероприятий)
title string Название
competenceId int ID компетенции в каталоге
actions array Мероприятия по компетенции (та же форма, что в ipr.action.get)

Обработка ошибок

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR id не передан или некорректен
NOT_FOUND Карточка не найдена или недоступна вызывающему
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (GET)

curl -G "https://{портал}/rest/{user_id}/{webhook_code}/ipr.ipr.get.json"
          -H "Accept: application/json"
          --data-urlencode "id=4201"
        

Пример ответа

{
          "result": {
            "result": {
              "id": 4201,
              "title": "ИПР: Наумова Алиса",
              "active": true,
              "userId": 15,
              "managerId": 1,
              "status": "WORK",
              "deadline": "2026-12-30",
              "startFact": "2026-06-18",
              "finishFact": null,
              "type": "IPR",
              "period": "12",
              "targetPositionId": 0,
              "observers": [8],
              "nextTemplateId": 0,
              "canEdit": true,
              "canDelete": false,
              "competencies": [
                {
                  "id": 9001,
                  "title": "Работа с обратной связью",
                  "competenceId": 1049,
                  "actions": [
                    {
                      "id": 12001,
                      "title": "Курс «Обратная связь 360»",
                      "resourceType": "course",
                      "resourceId": 305,
                      "deadline": "2026-09-30",
                      "dateClosed": null,
                      "active": true
                    }
                  ]
                }
              ],
              "dateCreate": "18.06.2026 12:07:44",
              "timestampX": "18.06.2026 12:07:44"
            },
            "total": null,
            "next": null,
            "error": null
          }
        }
        

См. также

Предыдущая
Следующая