Riepilogo degli errori edge

GET

apps

{app_id}

network

errors

Riepilogo degli errori edge

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/errors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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 }
      }
    ]
  }
}

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.

I cache miss condividono un unico limite di 20 richieste ogni 60 secondi per proprietario dell’applicazione, tra gli endpoint analytics, errors, logs e performance. Le risposte memorizzate nella cache non vengono conteggiate. Nei periodi di carico elevato sull’intera piattaforma, l’endpoint può invece restituire i dati più recenti memorizzati nella cache per la finestra richiesta. Restituisce un riepilogo vuoto quando non ci sono errori corrispondenti o quando la finestra precede la data di creazione dell’applicazione.

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope apps:read. Poiché gli errori 4xx includono richieste causate dal client, come probe di scanner e link scaduti, sono esclusi per impostazione predefinita; abilita include_4xx=true solo quando hai effettivamente bisogno di quel rumore, ad esempio durante un audit del traffico bot. I codici 5xx riflettono problemi all’edge o nell’applicazione stessa, quindi sono sempre inclusi. Questo endpoint è disponibile su ogni piano, come Analytics del Sito Web. Se hai bisogno del dettaglio per singola richiesta invece di conteggi aggregati, vedi Log di rete (solo Pro ed Enterprise). Per la latenza invece del tasso di errore, vedi Prestazioni di Rete.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

string

obbligatorio

Timestamp di inizio in formato ISO 8601 per la finestra di analisi.

string

obbligatorio

Timestamp di fine in formato ISO 8601. Deve essere successivo a start.

string

Se includere le risposte 4xx insieme agli errori 5xx. Accetta true o false. Il valore predefinito è false.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

object

Riepilogo aggregato degli errori per la finestra.

Mostra Mostra oggetto response

object

Totali di alto livello per la finestra.

Mostra Mostra oggetto summary

integer

Numero totale di risposte di errore nella finestra.

object

Totali suddivisi per classe di stato HTTP.

Mostra Mostra oggetto by_class

integer

Totale risposte 4xx (popolato solo quando include_4xx=true).

integer

Totale risposte 5xx.

array

Numero di richieste raggruppate per ogni singolo codice di stato HTTP osservato.

Mostra Mostra elemento by_status

integer

Codice di stato HTTP (es. 502, 504).

integer

Totale richieste che hanno restituito questo codice di stato.

array

Conteggi suddivisi per intervallo temporale (bucket) lungo la finestra di analisi.

Mostra Mostra elemento timeseries

string

Timestamp di inizio del bucket in formato ISO 8601.

object

Oggetto con chiave il codice di stato HTTP e valore il conteggio osservato in questo bucket.

integer

Totale errori osservati in questo bucket.

array

Percorsi che hanno prodotto più errori durante la finestra.

Mostra Mostra elemento top_paths

string

Percorso della richiesta.

string

Metodo HTTP.

integer

Totale errori per questo percorso/metodo.

object

Conteggi per codice di stato HTTP osservato per questo percorso/metodo.

array

Totali aggregati degli errori raggruppati per metodo HTTP.

Mostra Mostra elemento by_method

string

Metodo HTTP.

integer

Totale errori per questo metodo.

object

Conteggi per codice di stato HTTP osservato per questo metodo.

{
  "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 }
      }
    ]
  }
}

Errori comuni

Codice	HTTP	Significato
`INVALID_TIME_RANGE`	400	`start`/`end` mancanti, malformati o con l’intervallo temporale invertito.
`RATE_LIMITED`	429	È stato raggiunto il limite condiviso dei cache miss. Attendi e riprova.
`UNABLE_TO_FETCH_ERRORS`	500	Recupero dei dati di errore dal provider edge non riuscito.
`ANALYTICS_BUSY`	503	Le analytics edge sono temporaneamente sovraccariche. Riprova tra un minuto.

Vedi anche

CLI: squarecloud app network errors
SDK: api.apps.network.errors() (JavaScript), client.apps.network.errors() (Python), c.Apps.Network.Errors() (Go)

Riepilogo degli errori edge

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/errors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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 }
      }
    ]
  }
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Riepilogo degli errori edge

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche