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

# Registros de red

> Obtén los registros edge por solicitud de los dominios de la aplicación.

Devuelve los registros edge por solicitud (HTTP, país, estado, bytes) del dominio principal de la aplicación y de cualquier dominio personalizado configurado. La ventana máxima de retención es de 7 días; el inicio se ajusta a la fecha de creación de la aplicación.

<Info>
  Disponible solo en los planes **Pro** y **Enterprise**. Límite de solicitudes con fallo de caché: 10 solicitudes cada 60 segundos por propietario.
</Info>

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clave de API de tu cuenta. Puedes encontrarla en la [configuración de tu cuenta](https://squarecloud.app/es/account/security).
</ParamField>

### Parámetros

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.
</ParamField>

<ParamField query="start" type="string" placeholder="ISO 8601 timestamp" required>
  Marca de tiempo de inicio en ISO 8601. No puede ser anterior a la fecha de creación de la aplicación ni tener más de 7 días.
</ParamField>

<ParamField query="end" type="string" placeholder="ISO 8601 timestamp" required>
  Marca de tiempo de fin en ISO 8601. Debe ser posterior a `start`.
</ParamField>

### Respuesta

<ResponseField name="status" type="string">
  Indica si la llamada fue exitosa. `success` si fue exitosa, `error` si no.
</ResponseField>

<ResponseField name="response" type="array">
  El contenido de la respuesta.

  <Expandable title="Alternar objeto">
    <ResponseField name="timestamp" type="string">
      Marca de tiempo de la solicitud en formato ISO.
    </ResponseField>

    <ResponseField name="client" type="object">
      Información sobre el cliente que realizó la solicitud.

      <Expandable title="Alternar objeto client">
        <ResponseField name="ip" type="string | null">La dirección IP del cliente.</ResponseField>
        <ResponseField name="country" type="string | null">El código de país del cliente.</ResponseField>
        <ResponseField name="location" type="string | null">La ubicación aproximada del cliente.</ResponseField>
        <ResponseField name="asn" type="string">El ASN del cliente.</ResponseField>
        <ResponseField name="agent" type="string | null">El user agent del cliente.</ResponseField>
        <ResponseField name="category" type="string | null">La categoría del cliente (p. ej. bot, human).</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="request" type="object">
      Información sobre la solicitud entrante.

      <Expandable title="Alternar objeto request">
        <ResponseField name="mitigated" type="boolean">Indica si la solicitud fue mitigada por las protecciones edge.</ResponseField>
        <ResponseField name="method" type="string">Método HTTP utilizado.</ResponseField>
        <ResponseField name="host" type="string">Valor del encabezado Host.</ResponseField>
        <ResponseField name="path" type="string">Ruta de la solicitud.</ResponseField>
        <ResponseField name="query" type="string | null">Cadena de consulta.</ResponseField>
        <ResponseField name="protocol" type="string">Protocolo utilizado (p. ej. HTTP/2).</ResponseField>
        <ResponseField name="referer" type="string | null">Valor del encabezado Referer.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="response" type="object">
      Información sobre la respuesta servida en el edge.

      <Expandable title="Alternar objeto response">
        <ResponseField name="status" type="integer">Código de estado HTTP devuelto.</ResponseField>
        <ResponseField name="contentType" type="string | null">Tipo de contenido de la respuesta.</ResponseField>
        <ResponseField name="cache" type="string | null">Estado de la caché (p. ej. 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>