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

# Log di rete

> Ottieni i log edge per richiesta dei domini dell'applicazione.

Restituisce i log edge per richiesta (HTTP, paese, stato, byte) del dominio principale dell'applicazione e di qualsiasi dominio personalizzato configurato. La finestra di conservazione massima è di 7 giorni; l'inizio viene limitato alla data di creazione dell'applicazione.

<Info>
  Disponibile solo sui piani **Pro** ed **Enterprise**. Limite di frequenza in caso di cache miss: 10 richieste ogni 60 secondi per proprietario.
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La chiave API del tuo account. Puoi trovarla nelle [impostazioni del tuo account](https://squarecloud.app/it/account/security).
</ParamField>

### Parametri

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID dell'applicazione. Puoi trovarlo nell'URL della dashboard della tua applicazione.
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  Timestamp di inizio in formato ISO 8601. Non può essere precedente alla data di creazione dell'applicazione né più vecchio di 7 giorni.
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  Timestamp di fine in formato ISO 8601. Deve essere successivo a `start`.
</ParamField>

### Risposta

<ResponseField name="status" type="string">
  Indica se la chiamata è andata a buon fine. `success` in caso di successo, `error` in caso contrario.
</ResponseField>

<ResponseField name="response" type="array">
  Il contenuto della risposta.

  <Expandable title="Mostra oggetto">
    <ResponseField name="timestamp" type="string">
      Timestamp della richiesta in formato ISO.
    </ResponseField>

    <ResponseField name="client" type="object">
      Informazioni sul client che ha effettuato la richiesta.

      <Expandable title="Mostra oggetto client">
        <ResponseField name="ip" type="string | null">L'indirizzo IP del client.</ResponseField>
        <ResponseField name="country" type="string | null">Il codice paese del client.</ResponseField>
        <ResponseField name="location" type="string | null">La posizione approssimativa del client.</ResponseField>
        <ResponseField name="asn" type="string">L'ASN del client.</ResponseField>
        <ResponseField name="agent" type="string | null">Lo user agent del client.</ResponseField>
        <ResponseField name="category" type="string | null">La categoria del client (es. bot, human).</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="request" type="object">
      Informazioni sulla richiesta in ingresso.

      <Expandable title="Mostra oggetto request">
        <ResponseField name="mitigated" type="boolean">Se la richiesta è stata mitigata dalle protezioni edge.</ResponseField>
        <ResponseField name="method" type="string">Metodo HTTP usato.</ResponseField>
        <ResponseField name="host" type="string">Valore dell'header Host.</ResponseField>
        <ResponseField name="path" type="string">Percorso della richiesta.</ResponseField>
        <ResponseField name="query" type="string | null">Query string.</ResponseField>
        <ResponseField name="protocol" type="string">Protocollo usato (es. HTTP/2).</ResponseField>
        <ResponseField name="referer" type="string | null">Valore dell'header Referer.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="response" type="object">
      Informazioni sulla risposta servita all'edge.

      <Expandable title="Mostra oggetto response">
        <ResponseField name="status" type="integer">Codice di stato HTTP restituito.</ResponseField>
        <ResponseField name="contentType" type="string | null">Content type della risposta.</ResponseField>
        <ResponseField name="cache" type="string | null">Stato della cache (es. 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>