Aufschlüsselung der Edge-Fehler abrufen

GET

apps

{app_id}

network

errors

Aufschlüsselung der Edge-Fehler abrufen

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.

Cache-Misses teilen sich ein gemeinsames Limit von 20 Anfragen pro 60 Sekunden pro Eigentümer der Anwendung, über die Endpunkte Analytics, Errors, Logs und Performance hinweg. Zwischengespeicherte Antworten zählen nicht. In Zeiten hoher Last auf der gesamten Plattform kann der Endpunkt stattdessen die neuesten zwischengespeicherten Daten für das angeforderte Zeitfenster zurückgeben. 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 dein Konto. Du findest ihn in deinen Kontoeinstellungen.

Erfordert einen API-Schlüssel mit dem Scope apps:read. 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 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, wenn ja, error, wenn nicht.

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.
`RATE_LIMITED`	429	Das gemeinsame Limit für Cache-Misses wurde erreicht. Warte und versuche es erneut.
`UNABLE_TO_FETCH_ERRORS`	500	Die Fehlerdaten konnten nicht vom Edge-Provider abgerufen werden.
`ANALYTICS_BUSY`	503	Die Edge-Analytics sind vorübergehend ausgelastet. Versuche es in einer Minute erneut.

Siehe auch

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

Aufschlüsselung der Edge-Fehler abrufen

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

Erste Schritte

Konto

Anwendungen

Datenbanken

Workspaces

KI

Aufschlüsselung der Edge-Fehler abrufen

Parameter

Antwort

Häufige Fehler

Siehe auch

​Parameter

​Antwort

​Häufige Fehler

​Siehe auch

Parameter

Antwort

Häufige Fehler

Siehe auch