DriveB

37. Tags da Ordem de Serviço

Gerencia as tags (etiquetas) associadas a uma Ordem de Serviço (OS), permitindo classificação, marcação e filtragem por características específicas (ex.: origem da tag — sistema ou usuário — e tipo de tag).


Funcionalidades Principais

Abaixo estão os atalhos para as operações mais utilizadas neste módulo:


Consultar tags de uma Ordem de Serviço

Retorna todas as tags associadas a uma OS específica, com suporte a filtro.

Endpoint: /api/service-requests/{id}/tags

Método: GET

Parâmetros:

  • id (path, obrigatório, integer) — Identificador da Ordem de Serviço (OS).
  • filterDTO (query, obrigatório, tipo não especificado ⚠️) — Objeto/parâmetros de filtro das tags.

Response body:

[
{
"id": 0,
"name": "string",
"fromSystem": true,
"tagType": "string"
}
]

Atualizar tags de uma Ordem de Serviço

Substitui/atualiza o conjunto de tags associadas a uma OS específica.

Endpoint: /api/service-requests/{id}/tags

Método: PUT

Parâmetros:

  • id (path, obrigatório, integer) — Identificador da Ordem de Serviço (OS).

Request body:

[
{
"name": "string",
"tagType": "string"
}
]

Response body:

[
{
"id": 0,
"name": "string",
"fromSystem": true,
"tagType": "string"
}
]