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

# Logs réseau

> Obtenez les logs edge par requête pour les domaines de l'application.

Renvoie les logs edge par requête (HTTP, pays, statut, octets) pour le domaine principal de l'application et tout domaine personnalisé configuré. La fenêtre de rétention maximale est de 7 jours ; le début est borné à la date de création de l'application.

<Info>
  Disponible uniquement sur les plans **Pro** et **Enterprise**. Limite de débit en cas de cache miss : 10 requêtes par 60 secondes par propriétaire.
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

### Paramètres

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  L'ID de l'application. Vous pouvez le trouver dans l'URL du tableau de bord de votre application.
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  Horodatage de début ISO 8601. Ne peut pas être antérieur à la date de création de l'application ni plus ancien que 7 jours.
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  Horodatage de fin ISO 8601. Doit être postérieur à `start`.
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  Indique si l'appel a réussi. `success` en cas de succès, `error` sinon.
</ResponseField>

<ResponseField name="response" type="array">
  Le contenu de la réponse.

  <Expandable title="Afficher l'objet">
    <ResponseField name="timestamp" type="string">
      Horodatage de la requête au format ISO.
    </ResponseField>

    <ResponseField name="client" type="object">
      Informations sur le client ayant effectué la requête.

      <Expandable title="Afficher l'objet client">
        <ResponseField name="ip" type="string | null">L'adresse IP du client.</ResponseField>
        <ResponseField name="country" type="string | null">Le code pays du client.</ResponseField>
        <ResponseField name="location" type="string | null">La localisation approximative du client.</ResponseField>
        <ResponseField name="asn" type="string">L'ASN du client.</ResponseField>
        <ResponseField name="agent" type="string | null">Le user agent du client.</ResponseField>
        <ResponseField name="category" type="string | null">La catégorie du client (par ex. bot, humain).</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="request" type="object">
      Informations sur la requête entrante.

      <Expandable title="Afficher l'objet request">
        <ResponseField name="mitigated" type="boolean">Indique si la requête a été atténuée par les protections edge.</ResponseField>
        <ResponseField name="method" type="string">Méthode HTTP utilisée.</ResponseField>
        <ResponseField name="host" type="string">Valeur de l'en-tête Host.</ResponseField>
        <ResponseField name="path" type="string">Chemin de la requête.</ResponseField>
        <ResponseField name="query" type="string | null">Chaîne de requête.</ResponseField>
        <ResponseField name="protocol" type="string">Protocole utilisé (par ex. HTTP/2).</ResponseField>
        <ResponseField name="referer" type="string | null">Valeur de l'en-tête Referer.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="response" type="object">
      Informations sur la réponse servie au niveau de l'edge.

      <Expandable title="Afficher l'objet response">
        <ResponseField name="status" type="integer">Code de statut HTTP renvoyé.</ResponseField>
        <ResponseField name="contentType" type="string | null">Type de contenu de la réponse.</ResponseField>
        <ResponseField name="cache" type="string | null">Statut du cache (par ex. 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>