API: согласования — API

Главная / Документация / APIAPI: согласованияСогласования: полный перечень из 18 методов с параметрами и схемами тел.Обновлено 24.06.2026Пути - без префикса `/api/v1`. Детальные схемы - в `/api/docs`.Маршруты согласования (`/approval-routes`)

Метод

Путь

Право

GET

`/approval-routes`

`approval_routes.read`

GET

`/approval-routes/{route_id}`

`approval_routes.read`

POST

`/approval-routes`

`approval_routes.create`

PUT

`/approval-routes/{route_id}`

`approval_routes.update`

DELETE

`/approval-routes/{route_id}`

`approval_routes.delete`

Маршрут содержит этапы (`parallel` или `sequential`) с участниками (тип `role` или `employee`, признак обязательности). Признак `is_default_for_qc` - маршрут по умолчанию для ПКК.Заявки на согласование (`/approval-requests`)

Метод

Путь

Право

POST

`/approval-requests`

`approvals.create`

POST

`/approval-requests/attachments`

`approvals.create`

GET

`/approval-requests`

`approvals.read`

GET

`/approval-requests/{request_id}`

`approvals.read`

GET

`/approval-requests/{request_id}/pdf`

`approvals.read`

GET

`/approval-requests/{request_id}/history`

`approvals.read`

Решения по шагам и отмена:

Метод

Путь

Назначение

POST

`/approval-requests/{request_id}/steps/{step_id}/approve`

Согласовать шаг

POST

`/approval-requests/{request_id}/steps/{step_id}/reject`

Отклонить шаг

POST

`/approval-requests/{request_id}/steps/{step_id}/delegate`

Делегировать шаг

POST

`/approval-requests/{request_id}/cancel`

Отменить заявку (инициатор)

Статусы заявки: `in_progress`, `approved`, `rejected`, `returned_to_initiator`, `cancelled`. Тип цели (`target_type`) указывает на согласуемый объект (например, `custom_document` для документа).Заместители (`/me/substitutes`)

Метод

Путь

Назначение

GET

`/me/substitutes`

Список своих заместителей

POST

`/me/substitutes`

Назначить заместителя

DELETE

`/me/substitutes/{substitute_id}`

Удалить заместителя

Заместитель может действовать по согласованиям пользователя. Это подтверждает связь вкладки "Заместители" профиля с модулем согласований.См. также: `guide-approvals`, `cat-routes`, `guide-profile` (заместители).Документация соответствует версии продукта 0.9.0. Дата проверки: 2026-06-23.

Интеграции и REST API

Функциональная карта