> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Errori di rete

> Ottieni un riepilogo aggregato degli errori edge 5xx (e facoltativamente 4xx) dell'applicazione.

Restituisce il conteggio aggregato degli errori edge dell'applicazione su una finestra temporale, raggruppati per codice di stato, intervallo temporale (bucket), percorso della richiesta e metodo HTTP. Per impostazione predefinita vengono incluse solo le risposte 5xx; passa `include_4xx=true` per conteggiare anche le risposte 4xx.

<Info>
  Limite di frequenza in caso di cache miss: 15 richieste ogni 60 secondi per proprietario. Restituisce un riepilogo vuoto quando non ci sono errori corrispondenti o quando la finestra precede la data di creazione dell'applicazione.
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La chiave API del tuo account. Puoi trovarla nelle [impostazioni del tuo account](https://squarecloud.app/it/account/security).
</ParamField>

### Parametri

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID dell'applicazione. Puoi trovarlo nell'URL della dashboard della tua applicazione.
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  Timestamp di inizio in formato ISO 8601 per la finestra di analisi.
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  Timestamp di fine in formato ISO 8601. Deve essere successivo a `start`.
</ParamField>

<ParamField query="include_4xx" type="string" placeholder="false">
  Se includere le risposte 4xx insieme agli errori 5xx. Accetta `true` o `false`. Il valore predefinito è `false`.
</ParamField>

### Risposta

<ResponseField name="status" type="string">
  Indica se la chiamata è andata a buon fine. `success` in caso di successo, `error` in caso contrario.
</ResponseField>

<ResponseField name="response" type="object">
  Riepilogo aggregato degli errori per la finestra.

  <Expandable title="Mostra oggetto response">
    <ResponseField name="summary" type="object">
      Totali di alto livello per la finestra.

      <Expandable title="Mostra oggetto summary">
        <ResponseField name="total" type="integer">Numero totale di risposte di errore nella finestra.</ResponseField>

        <ResponseField name="by_class" type="object">
          Totali suddivisi per classe di stato HTTP.

          <Expandable title="Mostra oggetto by_class">
            <ResponseField name="4xx" type="integer">Totale risposte 4xx (popolato solo quando `include_4xx=true`).</ResponseField>
            <ResponseField name="5xx" type="integer">Totale risposte 5xx.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_status" type="array">
      Numero di richieste raggruppate per ogni singolo codice di stato HTTP osservato.

      <Expandable title="Mostra elemento by_status">
        <ResponseField name="status" type="integer">Codice di stato HTTP (es. `502`, `504`).</ResponseField>
        <ResponseField name="requests" type="integer">Totale richieste che hanno restituito questo codice di stato.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="timeseries" type="array">
      Conteggi suddivisi per intervallo temporale (bucket) lungo la finestra di analisi.

      <Expandable title="Mostra elemento timeseries">
        <ResponseField name="date" type="string">Timestamp di inizio del bucket in formato ISO 8601.</ResponseField>
        <ResponseField name="buckets" type="object">Oggetto con chiave il codice di stato HTTP e valore il conteggio osservato in questo bucket.</ResponseField>
        <ResponseField name="total" type="integer">Totale errori osservati in questo bucket.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="top_paths" type="array">
      Percorsi che hanno prodotto più errori durante la finestra.

      <Expandable title="Mostra elemento top_paths">
        <ResponseField name="path" type="string">Percorso della richiesta.</ResponseField>
        <ResponseField name="method" type="string">Metodo HTTP.</ResponseField>
        <ResponseField name="total" type="integer">Totale errori per questo percorso/metodo.</ResponseField>
        <ResponseField name="by_status" type="object">Conteggi per codice di stato HTTP osservato per questo percorso/metodo.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_method" type="array">
      Totali aggregati degli errori raggruppati per metodo HTTP.

      <Expandable title="Mostra elemento by_method">
        <ResponseField name="method" type="string">Metodo HTTP.</ResponseField>
        <ResponseField name="total" type="integer">Totale errori per questo metodo.</ResponseField>
        <ResponseField name="by_status" type="object">Conteggi per codice di stato HTTP osservato per questo metodo.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "summary": {
        "total": 42,
        "by_class": {
          "4xx": 0,
          "5xx": 42
        }
      },
      "by_status": [
        { "status": 502, "requests": 30 },
        { "status": 504, "requests": 12 }
      ],
      "timeseries": [
        {
          "date": "2025-12-01T12:00:00.000Z",
          "buckets": { "502": 5, "504": 2 },
          "total": 7
        }
      ],
      "top_paths": [
        {
          "path": "/api/users",
          "method": "GET",
          "total": 18,
          "by_status": { "502": 15, "504": 3 }
        }
      ],
      "by_method": [
        {
          "method": "GET",
          "total": 30,
          "by_status": { "502": 22, "504": 8 }
        }
      ]
    }
  }
  ```
</ResponseExample>