> ## 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.

# Netzwerkfehler

> Rufe eine aggregierte Aufschlüsselung der 5xx- (und optional 4xx-) Edge-Fehler für die Anwendung ab.

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.

<Info>
  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.
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

### Parameter

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  ISO-8601-Startzeitstempel für den Analysezeitraum.
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  ISO-8601-Endzeitstempel. Muss nach `start` liegen.
</ParamField>

<ParamField query="include_4xx" type="string" placeholder="false">
  Ob 4xx-Antworten zusätzlich zu 5xx-Fehlern einbezogen werden. Akzeptiert `true` oder `false`. Standardwert ist `false`.
</ParamField>

### Antwort

<ResponseField name="status" type="string">
  Gibt an, ob der Aufruf erfolgreich war. `success` bei Erfolg, `error` andernfalls.
</ResponseField>

<ResponseField name="response" type="object">
  Aggregierte Fehleraufschlüsselung für den Zeitraum.

  <Expandable title="Antwortobjekt umschalten">
    <ResponseField name="summary" type="object">
      Übergeordnete Summen für den Zeitraum.

      <Expandable title="summary-Objekt umschalten">
        <ResponseField name="total" type="integer">Gesamtzahl der Fehlerantworten im Zeitraum.</ResponseField>

        <ResponseField name="by_class" type="object">
          Summen aufgeteilt nach HTTP-Statusklasse.

          <Expandable title="by_class-Objekt umschalten">
            <ResponseField name="4xx" type="integer">Gesamtzahl der 4xx-Antworten (nur befüllt, wenn `include_4xx=true`).</ResponseField>
            <ResponseField name="5xx" type="integer">Gesamtzahl der 5xx-Antworten.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_status" type="array">
      Anzahl der Anfragen gruppiert nach jedem einzelnen beobachteten HTTP-Statuscode.

      <Expandable title="by_status-Eintrag umschalten">
        <ResponseField name="status" type="integer">HTTP-Statuscode (z. B. `502`, `504`).</ResponseField>
        <ResponseField name="requests" type="integer">Gesamtzahl der Anfragen, die diesen Statuscode zurückgegeben haben.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="timeseries" type="array">
      Nach Zeitintervall gruppierte Zählungen über den Analysezeitraum.

      <Expandable title="timeseries-Eintrag umschalten">
        <ResponseField name="date" type="string">Startzeitstempel des Intervalls im ISO-8601-Format.</ResponseField>
        <ResponseField name="buckets" type="object">Objekt mit HTTP-Statuscodes als Schlüssel und der in diesem Intervall beobachteten Anzahl.</ResponseField>
        <ResponseField name="total" type="integer">Gesamtzahl der in diesem Intervall beobachteten Fehler.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="top_paths" type="array">
      Pfade, die während des Zeitraums die meisten Fehler verursacht haben.

      <Expandable title="top_paths-Eintrag umschalten">
        <ResponseField name="path" type="string">Anfragepfad.</ResponseField>
        <ResponseField name="method" type="string">HTTP-Methode.</ResponseField>
        <ResponseField name="total" type="integer">Gesamtzahl der Fehler für diesen Pfad/diese Methode.</ResponseField>
        <ResponseField name="by_status" type="object">Zählungen pro beobachtetem HTTP-Statuscode für diesen Pfad/diese Methode.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_method" type="array">
      Aggregierte Fehlersummen gruppiert nach HTTP-Methode.

      <Expandable title="by_method-Eintrag umschalten">
        <ResponseField name="method" type="string">HTTP-Methode.</ResponseField>
        <ResponseField name="total" type="integer">Gesamtzahl der Fehler für diese Methode.</ResponseField>
        <ResponseField name="by_status" type="object">Zählungen pro beobachtetem HTTP-Statuscode für diese Methode.</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>