# Opciones de clasificación (https://docs.pulsarml.com/es/v1/api-reference/stops/get-stops-classification-options)

**Scope requerido:** `stop_catalogs.read`.

Lista, por máquina, las clasificaciones que `PUT /v1/stops/classifications` acepta para sus paros:

* `generalCauses`: las causas generales del árbol de pérdidas de la máquina, cada una con las `specificCauses` que pueden ir debajo de ella.
* `components`: los componentes asignados a la máquina.

Una máquina sin árbol de pérdidas no tiene causas generales; a sus paros solo se les puede dar una `description`. Filtra la lista con `machineId`, repetido para varias máquinas:

```
GET /v1/stops/classification-options?machineId=12&machineId=13
```

## `GET /v1/stops/classification-options`

Base URLs:
- `https://draco.prod.pulsarml.com` — Producción
- `https://draco.stage.pulsarml.com` — Sandbox (staging)

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

### Query parameters

- `machineId` (array of integer, optional, nullable) — Solo estas máquinas, como las devuelve `GET /v1/machines`. Repítelo para varias máquinas (`machineId=12&machineId=13`). Todas tus máquinas si se omite.

### Responses

#### 200 — Una entrada por máquina

Type: array of object

- `machineId` (integer, required, e.g. `12`) — El ID de la máquina, tal como lo devuelve `GET /v1/machines`.
- `generalCauses` (array of object, required) — Las causas generales que aceptan los paros de la máquina, de su árbol de pérdidas. Vacío si la máquina no tiene árbol de pérdidas; en ese caso sus paros solo se pueden clasificar con una `description`.
  - `id` (string (uuid), required, e.g. `"f89b5866-2d26-45a1-8cfc-8295557594d8"`) — El id de la opción.
  - `name` (string, required, e.g. `"Bearing failure"`) — El nombre de la opción.
  - `specificCauses` (array of object, required) — Las causas específicas que pueden ir con esta causa general en la máquina. Vacío si no admite ninguna.
    - `id` (string (uuid), required, e.g. `"f89b5866-2d26-45a1-8cfc-8295557594d8"`) — El id de la opción.
    - `name` (string, required, e.g. `"Bearing failure"`) — El nombre de la opción.
- `components` (array of object, required) — Los componentes que se pueden indicar en los paros de la máquina.
  - `id` (string (uuid), required, e.g. `"f89b5866-2d26-45a1-8cfc-8295557594d8"`) — El id de la opción.
  - `name` (string, required, e.g. `"Bearing failure"`) — El nombre de la opción.

#### 401 — * `unauthenticated`: Las credenciales faltan, no son válidas o expiraron.

#### 403 — * `missing_scope`: Las credenciales son válidas, pero no tienen el scope que requiere este endpoint.

#### 422 — Error de validación

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)

#### 429 — * `rate_limited`: La API key superó su límite de solicitudes. Reintenta después de `Retry-After` segundos.

### Example request

```bash
curl -X GET 'https://draco.prod.pulsarml.com/v1/stops/classification-options' \
  -H 'x-api-key: <YOUR_API_KEY>'
```