Saltar al contenido principal
POST
/
faults
/
{faultId}
/
comment
Añadir un comentario a un fallo
curl --request POST \
  --url https://api.altostrat.io/faults/{faultId}/comment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "comment": "El ISP ha confirmado un corte de fibra en la zona. El tiempo estimado para la reparación es de 4 horas."
}'
{
  "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
  "resource_id": "dev_2j4k2l2j3k4l2j3k4",
  "customer_id": "cus_1i2j3k4l5m6n7o8p",
  "microservice_id": "wantunnel-monitor",
  "type": "wantunnel",
  "status": "unresolved",
  "severity": "CRITICAL",
  "message": "Conmutación por error del enlace WAN: El enlace primario (WAN1) está caído",
  "cause": "Sondeo fallido: Latencia excedió el umbral de 500ms",
  "created_at": "2025-10-21T12:00:00.000000Z",
  "resolved_at": null,
  "resource_ancestry_path": "site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4",
  "ttl": 1797825595,
  "comments": [
    {
      "user_id": "user_a1b2c3d4e5f6g7h8",
      "comment": "Contactado con el ISP, están investigando una interrupción local.",
      "created_at": "2025-10-21T12:05:30.000000Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Las solicitudes a la API se autentican mediante un JSON Web Token (JWT) proporcionado en la cabecera Authorization.

Path Parameters

​
faultId
string
required

El identificador único del fallo al que se añadirá el comentario.

Example:

"flt_31pkd1t8FvW7qZv0jG2a9kH5mB1"

Body

application/json

El contenido del comentario.

​
comment
string
required

El contenido de texto del comentario a añadir.

Maximum length: 2000
Example:

"El ISP ha confirmado un corte de fibra en la zona. El tiempo estimado para la reparación es de 4 horas."

Response

El objeto de fallo, ahora incluyendo el nuevo comentario.

El objeto Fault representa un problema o evento detectado dentro de la red.

​
id
string

Un identificador único para el objeto de fallo, con el prefijo flt_.

Example:

"flt_31pkd1t8FvW7qZv0jG2a9kH5mB1"

​
resource_id
string

El identificador único del recurso que experimentó el fallo.

Example:

"dev_2j4k2l2j3k4l2j3k4"

​
customer_id
string

El identificador único de la cuenta de cliente a la que pertenece este fallo.

Example:

"cus_1i2j3k4l5m6n7o8p"

​
microservice_id
string

El identificador del microservicio que informó el fallo.

Example:

"wantunnel-monitor"

​
type
string

La categoría o tipo del fallo.

Example:

"wantunnel"

​
status
enum<string>

El estado actual del fallo.

Opciones disponibles:
unresolved,
resolved
Example:

"unresolved"

​
severity
enum<string>

El nivel de severidad del fallo.

Opciones disponibles:
LOW,
MEDIUM,
HIGH,
CRITICAL,
WARNING
Example:

"CRITICAL"

​
message
string

Un resumen conciso y legible por humanos del fallo.

Example:

"Conmutación por error del enlace WAN: El enlace primario (WAN1) está caído"

​
cause
string

Una explicación detallada de la causa probable del fallo.

Example:

"Sondeo fallido: Latencia excedió el umbral de 500ms"

​
created_at
string<date-time>

La marca de tiempo de cuándo se detectó y creó el fallo por primera vez.

Example:

"2025-10-21T12:00:00.000000Z"

​
resolved_at
string<date-time> | null

La marca de tiempo de cuándo se resolvió el fallo. Nulo si el fallo todavía está activo.

Example:

null

​
resource_ancestry_path
string | null

Una cadena delimitada por barras verticales | que representa la ubicación jerárquica del recurso, utilizada para filtrar fallos por un recurso principal (p. ej., una sede específica).

Example:

"site_8a7b6c5d4e3f2g1h|dev_2j4k2l2j3k4l2j3k4"

​
ttl
integer | null

Una marca de tiempo Unix que indica cuándo el registro del fallo expirará automáticamente de la base de datos.

Example:

1797825595

​
comments
object[]

Una lista de comentarios asociados con el fallo, ordenados del más antiguo al más reciente.