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

# Netzwerk-Logs

> Rufe Edge-Logs pro Anfrage für die Domains der Anwendung ab.

Gibt Edge-Logs pro Anfrage (HTTP, Land, Status, Bytes) für die primäre Domain der Anwendung und jede konfigurierte Custom Domain zurück. Der maximale Aufbewahrungszeitraum beträgt 7 Tage; der Start wird auf das Erstellungsdatum der Anwendung begrenzt.

<Info>
  Nur in den Plänen **Pro** und **Enterprise** verfügbar. Rate-Limit bei Cache-Miss: 10 Anfragen pro 60 Sekunden pro Eigentümer.
</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. Darf nicht vor dem Erstellungsdatum der Anwendung oder älter als 7 Tage sein.
</ParamField>

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

### Antwort

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

<ResponseField name="response" type="array">
  Der Inhalt der Antwort.

  <Expandable title="Objekt umschalten">
    <ResponseField name="timestamp" type="string">
      Zeitstempel der Anfrage im ISO-Format.
    </ResponseField>

    <ResponseField name="client" type="object">
      Informationen über den Client, der die Anfrage gestellt hat.

      <Expandable title="client-Objekt umschalten">
        <ResponseField name="ip" type="string | null">Die IP-Adresse des Clients.</ResponseField>
        <ResponseField name="country" type="string | null">Der Ländercode des Clients.</ResponseField>
        <ResponseField name="location" type="string | null">Der ungefähre Standort des Clients.</ResponseField>
        <ResponseField name="asn" type="string">Die ASN des Clients.</ResponseField>
        <ResponseField name="agent" type="string | null">Der User-Agent des Clients.</ResponseField>
        <ResponseField name="category" type="string | null">Die Client-Kategorie (z. B. Bot, Mensch).</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="request" type="object">
      Informationen über die eingehende Anfrage.

      <Expandable title="request-Objekt umschalten">
        <ResponseField name="mitigated" type="boolean">Ob die Anfrage durch Edge-Schutzmaßnahmen abgewehrt wurde.</ResponseField>
        <ResponseField name="method" type="string">Verwendete HTTP-Methode.</ResponseField>
        <ResponseField name="host" type="string">Wert des Host-Headers.</ResponseField>
        <ResponseField name="path" type="string">Anfragepfad.</ResponseField>
        <ResponseField name="query" type="string | null">Query-String.</ResponseField>
        <ResponseField name="protocol" type="string">Verwendetes Protokoll (z. B. HTTP/2).</ResponseField>
        <ResponseField name="referer" type="string | null">Wert des Referer-Headers.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="response" type="object">
      Informationen über die am Edge ausgelieferte Antwort.

      <Expandable title="response-Objekt umschalten">
        <ResponseField name="status" type="integer">Zurückgegebener HTTP-Statuscode.</ResponseField>
        <ResponseField name="contentType" type="string | null">Content-Type der Antwort.</ResponseField>
        <ResponseField name="cache" type="string | null">Cache-Status (z. B. HIT, MISS).</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": [
      {
        "timestamp": "2025-12-01T12:00:00.000Z",
        "client": {
          "ip": "203.0.113.45",
          "country": "BR",
          "location": "São Paulo",
          "asn": "12345 - Example ISP",
          "agent": "Mozilla/5.0",
          "category": null
        },
        "request": {
          "mitigated": false,
          "method": "GET",
          "host": "my-app.squareweb.app",
          "path": "/api/users",
          "query": "?limit=10",
          "protocol": "HTTP/2",
          "referer": null
        },
        "response": {
          "status": 200,
          "contentType": "application/json",
          "cache": "MISS"
        }
      }
    ]
  }
  ```
</ResponseExample>