Шаблон чек-листа оборудования

Все операции. Авторизация. Запросы и повторы.

Все пути в этом файле дополняют /api/v1 на домене организации.

Описание и ограничения

Назначение

Повторно используемые обязательные и необязательные работы конкретной единицы оборудования.

Поля и назначение

Обязательность и null указаны в схемах каждой операции ниже.

Доступ и выборка

equipment_checklists:read/write и права просмотра/изменения оборудования; ссылка на работу дополнительно проверяется.

Правила и связи

• Изменение шаблона действует на будущие выполнения, а не переписывает сохранённые снимки начатого ТО.
• Идентификатор пункта принадлежит equipment_id.
• Создание пункта не означает выполнение работы или начисление стоимости.

Формат запросов и результат

• Публичная карточка содержит только id, equipment_id, operation_id, description, sort_order, is_required, is_active, version, updated_at.
• operation_id допускает null. Ручной пункт без работы требует непустого description; строка из пробелов не подходит. Наличие каталожной работы проверяется вместе со штатными правами её просмотра, отдельное разрешение подключения operations:read для записи ссылки не требуется.
• sort_order — неотрицательное JSON-целое, is_required/is_active — логические значения JSON. Строковые замены "1"/"true" не принимаются. Неизвестные поля отклоняются.
• Создание возвращает 201, изменение и архивация — 200. /delete принимает {} и устанавливает is_active=false; сохранённые результаты выполнения и ссылки на источник остаются целыми. Повтор архивации с новым ключом и актуальной версией не меняет данные.
• Список поддерживает общую курсорную пагинацию и фильтры filter[operation_id], filter[is_required], filter[is_active]. Логические фильтры используют строки true/false. GET карточки поддерживает ETag и If-None-Match после проверки доступа.
• Запись пункта и обновление updated_at родителя входят в одну транзакцию с результатом операции и событиями. Запрос без изменений не меняет версии и не порождает событий. Изменения шаблона не переписывают снимки уже начатых выполнений.
• Повтор проверяет текущий доступ к исходному и текущему родителю. Для оборудования после смены клиента или площадки прежняя запись об операции закрывается ответом 404. Физически удалённый штатной панелью пункт не создаётся заново при повторе ранее принятого POST; доступный исторический ответ возвращается по записи об операции.

Операции

GET /equipment/{parentId}/checklist-items

Список с фильтрами и пагинацией.

Доступ. Разрешения подключения: equipment_checklists:read. Права сотрудника: «ТОиР — Оборудование → Просмотр». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff \
  "$API/equipment/101/checklist-items" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json"

POST /equipment/{parentId}/checklist-items

Создание.

Доступ. Разрешения подключения: equipment_checklists:write. Права сотрудника: «ТОиР — Оборудование → Изменение». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Тело запроса

Content-Type: application/json. Тело обязательно.

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

У принятого POST Location и meta.operation_id указывают на журнал операции; ETag отсутствует. При повторе запроса сохраняются исходные data/meta, добавляется Idempotency-Replayed: true. Версии передавайте по назначению, указанному в описании ресурса.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff --request POST \
  "$API/equipment/101/checklist-items" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: example:v1-equipment-checklists-create:001" \
  --header "If-Resource-Version: $RESOURCE_VERSION" \
  --header "Content-Type: application/json" \
  --data-binary '@examples/requests/v1.equipment-checklists.create.json'

GET /equipment/{parentId}/checklist-items/{id}

Карточка.

Доступ. Разрешения подключения: equipment_checklists:read. Права сотрудника: «ТОиР — Оборудование → Просмотр». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff \
  "$API/equipment/101/checklist-items/101" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json"

POST /equipment/{parentId}/checklist-items/{id}/update

Изменение разрешённых полей.

Доступ. Разрешения подключения: equipment_checklists:write. Права сотрудника: «ТОиР — Оборудование → Изменение». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Тело запроса

Content-Type: application/json. Тело обязательно.

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

У принятого POST Location и meta.operation_id указывают на журнал операции; ETag отсутствует. При повторе запроса сохраняются исходные data/meta, добавляется Idempotency-Replayed: true. Версии передавайте по назначению, указанному в описании ресурса.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff --request POST \
  "$API/equipment/101/checklist-items/101/update" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: example:v1-equipment-checklists-update:001" \
  --header "If-Resource-Version: $RESOURCE_VERSION" \
  --header "Content-Type: application/json" \
  --data-binary '@examples/requests/v1.equipment-checklists.update.json'

POST /equipment/{parentId}/checklist-items/{id}/delete

Архивация или удаление с проверкой зависимостей.

Доступ. Разрешения подключения: equipment_checklists:write. Права сотрудника: «ТОиР — Оборудование → Изменение». Дополнительно действуют доступ к записям, мастерским, модулям и условия полей из описания ресурса выше.

Параметры

Тело запроса

Content-Type: application/json. Тело обязательно.

Тело — пустой JSON-объект {}. Другие ключи не принимаются.

Ответы

Каждый ответ содержит новый X-Request-Id в заголовке. Общие транспортные отказы и правила повтора действуют также при отказе до контроллера; см. ошибки.

У принятого POST Location и meta.operation_id указывают на журнал операции; ETag отсутствует. При повторе запроса сохраняются исходные data/meta, добавляется Idempotency-Replayed: true. Версии передавайте по назначению, указанному в описании ресурса.

Пример запроса

Запускается из каталога комплекта после настройки переменных в быстром старте. Замените демонстрационные идентификаторы 101 и UUID идентификаторами доступных записей. $RESOURCE_VERSION берётся из GET владельца версии, описанного выше. Для нового действия сохраните новый ключ; для повтора используйте прежний.

curl --silent --show-error --globoff --request POST \
  "$API/equipment/101/checklist-items/101/delete" \
  --header "Authorization: Bearer $SERVICEAPP_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: example:v1-equipment-checklists-delete:001" \
  --header "If-Resource-Version: $RESOURCE_VERSION" \
  --header "Content-Type: application/json" \
  --data-binary '@examples/requests/v1.equipment-checklists.delete.json'