Netzwerkfehler - Square Cloud

GET

apps

{app_id}

network

errors

Netzwerkfehler

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

Gibt aggregierte Edge-Fehlerzahlen für die Anwendung über einen Zeitraum zurück, gruppiert nach Statuscode, Zeitintervall, Anfragepfad und HTTP-Methode. Standardmäßig sind nur 5xx-Antworten enthalten; übergib include_4xx=true, um auch 4xx-Antworten zu zählen.

Rate-Limit bei Cache-Miss: 15 Anfragen pro 60 Sekunden pro Eigentümer. Gibt eine leere Aufschlüsselung zurück, wenn keine passenden Fehler vorliegen oder wenn der Zeitraum vor dem Erstellungsdatum der Anwendung liegt.

string

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Da 4xx-Fehler auch clientseitig verursachte Treffer wie Scanner-Sondierungen und abgelaufene Links einschließen, sind sie standardmäßig ausgeschlossen; aktiviere include_4xx=true nur, wenn du dieses Rauschen gezielt brauchst, etwa bei der Auswertung von Bot-Traffic. 5xx-Codes spiegeln Probleme am Edge oder in der Anwendung selbst wider und sind daher immer enthalten. Dieser Endpoint ist in jedem kostenpflichtigen Tarif verfügbar, genau wie Netzwerk-Analytics. Wenn du statt aggregierter Zahlen Details pro Anfrage benötigst, siehe Netzwerk-Logs (nur Pro und Enterprise). Für Latenz statt Fehlerquote siehe Netzwerk-Performance.

Parameter

string

erforderlich

Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.

string

erforderlich

ISO-8601-Startzeitstempel für den Analysezeitraum.

string

erforderlich

ISO-8601-Endzeitstempel. Muss nach start liegen.

string

Ob 4xx-Antworten zusätzlich zu 5xx-Fehlern einbezogen werden. Akzeptiert true oder false. Standardwert ist false.

Antwort

string

Gibt an, ob der Aufruf erfolgreich war. success bei Erfolg, error andernfalls.

object

Aggregierte Fehleraufschlüsselung für den Zeitraum.

Anzeigen Antwortobjekt umschalten

object

Übergeordnete Summen für den Zeitraum.

Anzeigen summary-Objekt umschalten

integer

Gesamtzahl der Fehlerantworten im Zeitraum.

object

Summen aufgeteilt nach HTTP-Statusklasse.

Anzeigen by_class-Objekt umschalten

integer

Gesamtzahl der 4xx-Antworten (nur befüllt, wenn include_4xx=true).

integer

Gesamtzahl der 5xx-Antworten.

array

Anzahl der Anfragen gruppiert nach jedem einzelnen beobachteten HTTP-Statuscode.

Anzeigen by_status-Eintrag umschalten

integer

HTTP-Statuscode (z. B. 502, 504).

integer

Gesamtzahl der Anfragen, die diesen Statuscode zurückgegeben haben.

array

Nach Zeitintervall gruppierte Zählungen über den Analysezeitraum.

Anzeigen timeseries-Eintrag umschalten

string

Startzeitstempel des Intervalls im ISO-8601-Format.

object

Objekt mit HTTP-Statuscodes als Schlüssel und der in diesem Intervall beobachteten Anzahl.

integer

Gesamtzahl der in diesem Intervall beobachteten Fehler.

array

Pfade, die während des Zeitraums die meisten Fehler verursacht haben.

Anzeigen top_paths-Eintrag umschalten

string

Anfragepfad.

string

HTTP-Methode.

integer

Gesamtzahl der Fehler für diesen Pfad/diese Methode.

object

Zählungen pro beobachtetem HTTP-Statuscode für diesen Pfad/diese Methode.

array

Aggregierte Fehlersummen gruppiert nach HTTP-Methode.

Anzeigen by_method-Eintrag umschalten

string

HTTP-Methode.

integer

Gesamtzahl der Fehler für diese Methode.

object

Zählungen pro beobachtetem HTTP-Statuscode für diese Methode.

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

Häufige Fehler

Code	HTTP	Bedeutung
`INVALID_TIME_RANGE`	400	`start`/`end` fehlen, sind fehlerhaft formatiert oder kehren den Zeitraum um.
`UNABLE_TO_FETCH_ERRORS`	500	Die Fehlerdaten konnten nicht vom Edge-Provider abgerufen werden.

Netzwerkfehler

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

​Parameter

​Antwort

​Häufige Fehler

Parameter

Antwort

Häufige Fehler