# Pesquisar velocidades nominais (https://docs.pulsarml.com/pt/v1/api-reference/nominal-speeds/post-nominal-speeds-filters)

Pesquisa as velocidades configuradas para combinações de máquina e SKU.

Útil para auditorias: um par de máquina e SKU sem velocidade nominal, ou com uma claramente errada, é a causa mais comum de um valor de desempenho em que ninguém acredita.

## `POST /v1/nominal-speeds/filters`

Base URLs:
- `https://draco.prod.pulsarml.com` — Produção
- `https://draco.dev.pulsarml.com` — Desenvolvimento (sandbox)

Authentication: send your API key in the `x-api-key` header.

### Request body (`application/json`, required)

Type: object (`GetNominalSpeedsByFiltersRequestV1`)

- `page` (integer, optional, default `1`, > 0, e.g. `1`) — O número da página
- `limit` (integer, optional, default `10`, > 0, e.g. `10`) — O número de elementos por página
- `machines` (object, optional, nullable) — Critérios de filtro para máquinas
  - `search` (string, optional, nullable) — Termo de pesquisa para máquinas
  - `include` (array of integer, optional, nullable) — Elementos a incluir, por ID
  - `exclude` (array of integer, optional, nullable) — Elementos a excluir, por ID
- `skus` (object, optional, nullable) — Critérios de filtro para SKUs
  - `search` (string, optional, nullable) — Termo de pesquisa para SKUs
  - `include` (array of string, optional, nullable) — Elementos a incluir, por ID
  - `exclude` (array of string, optional, nullable) — Elementos a excluir, por ID
- `nominalSpeed` (object, optional, nullable) — Critérios de filtro para velocidades nominais
  - `greaterThan` (number, optional, nullable, e.g. `1`) — Maior do que
  - `greaterThanOrEqual` (number, optional, nullable, e.g. `1`) — Maior ou igual a
  - `lessThan` (number, optional, nullable, e.g. `1`) — Menor do que
  - `lessThanOrEqual` (number, optional, nullable, e.g. `1`) — Menor ou igual a
  - `equal` (number, optional, nullable, e.g. `1`) — Igual a
  - `notEqual` (number, optional, nullable, e.g. `1`) — Diferente de

### Responses

#### 200 — Uma página de velocidades nominais, com o total de resultados e de páginas

Type: object (`GetNominalSpeedsByFiltersResponseV1`)

- `totalCount` (integer, optional, default `100`) — O número total de elementos
- `totalPages` (integer, optional, default `10`) — O número total de páginas
- `currentPage` (integer, optional, default `1`) — A página atual
- `nominalSpeeds` (array of object, required)
  - `id` (string, required, e.g. `"36f7b519-d93e-4ec8-8245-7f4b8c123456"`) — O identificador único da velocidade nominal.
  - `machine` (object, required) — A máquina associada à velocidade nominal.
    - `id` (integer, required, e.g. `1`) — O identificador único da máquina.
    - `name` (string, required, e.g. `"machine 1"`) — O nome da máquina.
  - `sku` (object, required) — O SKU associado à velocidade nominal.
    - `id` (string, required, e.g. `"f1c3a9e9-1cef-4d1d-a6d7-e18607cbfa55"`) — O identificador único do SKU.
    - `name` (string, required, e.g. `"sku 1"`) — O nome do SKU.
    - `description` (string, required, e.g. `"sku 1 description"`) — A descrição do SKU.
    - `unit` (string, required, e.g. `"sku 1 unit"`) — A unidade do SKU.
  - `nominalSpeed` (number, required, e.g. `100`) — A velocidade nominal da máquina.
  - `countingFactor` (number, required, e.g. `1`) — O fator de contagem do sensor associado à máquina e ao SKU.
  - `createdAt` (string (date-time), required, e.g. `"2024-01-01T00:00:00.000Z"`) — A data e hora em que a velocidade nominal foi criada.
  - `updatedAt` (string (date-time), required, e.g. `"2024-01-01T00:00:00.000Z"`) — A data e hora da última atualização da velocidade nominal.
  - `deletedAt` (string (date-time), optional, nullable, e.g. `"2024-01-02T00:00:00.000Z"`) — A data e hora em que a velocidade nominal foi eliminada, se aplicável.

#### 422 — Erro de validação

Type: object (`HTTPValidationError`)

- `detail` (array of object, optional)
  - `loc` (array of string | integer, required)
  - `msg` (string, required)
  - `type` (string, required)
  - `input` (any, optional)
  - `ctx` (object, optional)

### Example request

```bash
curl -X POST 'https://draco.prod.pulsarml.com/v1/nominal-speeds/filters' \
  -H 'x-api-key: <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "limit": 10,
    "machines": {
      "exclude": [
        1
      ],
      "include": [
        1
      ],
      "search": "machine 1"
    },
    "skus": {
      "exclude": [
        "1145d032-975c-4cdb-a378-910aeb3f5865"
      ],
      "include": [
        "ffce6941-7dcf-4026-a396-0c4927f5bb49"
      ],
      "search": "sku 1"
    },
    "nominalSpeed": {
      "equal": 1,
      "greaterThan": 1,
      "greaterThanOrEqual": 1,
      "lessThan": 1,
      "lessThanOrEqual": 1,
      "notEqual": 1
    }
  }'
```