Vai al contenuto principale
GET
/
faults
Elenca tutti i guasti
curl --request GET \
  --url https://api.altostrat.io/faults \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "flt_31pkd1t8FvW7qZv0jG2a9kH5mB1",
      "resource_id": "dev_2j4k2l2j3k4l2j3k4",
      "customer_id": "cus_1i2j3k4l5m6n7o8p",
      "microservice_id": "wantunnel-monitor",
      "type": "wantunnel",
      "status": "unresolved",
      "severity": "CRITICAL",
      "message": "Failover del link WAN: il link primario (WAN1) non è attivo",
      "cause": "Sondaggio fallito: latenza superiore alla soglia di 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": "Contattato l'ISP, stanno investigando un'interruzione locale.",
          "created_at": "2025-10-21T12:05:30.000000Z"
        }
      ]
    }
  ],
  "meta": {
    "count": 50,
    "cursor": "eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h",
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

Le richieste API sono autenticate utilizzando un JSON Web Token (JWT) fornito nell'header Authorization.

Query Parameters

limit
integer
default:50

Un limite al numero di oggetti da restituire. Il limite può variare tra 1 e 100, e il valore predefinito è 50.

Required range: 1 <= x <= 100
cursor
string

Un cursore da utilizzare per la paginazione. Il cursor è una stringa opaca che specifica la posizione corrente nell'elenco.

Example:

"eyJQSyI6eyJTIjoiRkFVTFQjMzFwbGg4a2FhblB2R0h"

from
string<date-time>

Un timestamp in formato ISO 8601. Restituisce solo i guasti creati dopo questo orario.

Example:

"2025-10-20T10:00:00Z"

to
string<date-time>

Un timestamp in formato ISO 8601. Restituisce solo i guasti creati prima di questo orario.

Example:

"2025-10-21T10:00:00Z"

severity
enum<string>

Filtra i guasti per livello di gravità.

Opzioni disponibili:
LOW,
MEDIUM,
HIGH,
CRITICAL,
WARNING
type
string

Filtra i guasti per tipo, come site o wantunnel.

Example:

"wantunnel"

resource_id
string

Filtra i guasti per un identificatore di risorsa specifico.

Example:

"dev_2j4k2l2j3k4l2j3k4"

site
string

Filtra i guasti per un sito specifico e tutte le sue risorse figlie. Esegue una query gerarchica.

Example:

"site_8a7b6c5d4e3f2g1h"

status
enum<string>

Filtra i guasti per stato di risoluzione.

Opzioni disponibili:
unresolved,
resolved

Response

Un elenco paginato di guasti.

data
object[]
meta
object