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

Define a velocidade esperada para um ou vários pares de máquina e SKU. O corpo é um **array** JSON.

`nominalSpeed` tem de ser maior do que zero, e `machine` e `sku` aceitam cada um um `id` ou um `name`. `countingFactor` é `1` por predefinição e converte os impulsos do sensor na unidade do SKU: defina-o como `12` quando um impulso corresponde a uma caixa de doze.

## `POST /v1/nominal-speeds`

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: array of object

- `nominalSpeed` (number, required, > 0, e.g. `60`) — A velocidade nominal da máquina
- `countingFactor` (number, optional, default `1`, > 0, e.g. `60`) — O fator de contagem da máquina
- `machine` (object, required)
  - `id` (integer, optional, nullable, > 0, e.g. `1`) — O ID da máquina
  - `name` (string, optional, nullable, e.g. `"Machine 1"`) — O nome da máquina
- `sku` (object, required)
  - `id` (string, optional, nullable, e.g. `"9ce2c6b4-a1f4-4bf2-b5c8-10436d1018cc"`) — O ID do SKU
  - `name` (string, optional, nullable, e.g. `"sku 1"`) — O nome do SKU

### Responses

#### 200 — As velocidades nominais que foram criadas

Type: array of object

- `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' \
  -H 'x-api-key: <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "nominalSpeed": 60,
      "countingFactor": 60,
      "machine": {
        "id": 1,
        "name": "Machine 1"
      },
      "sku": {
        "id": "9ce2c6b4-a1f4-4bf2-b5c8-10436d1018cc",
        "name": "sku 1"
      }
    }
  ]'
```