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

# Errores de red

> Obtén un desglose agregado de los errores edge 5xx (y opcionalmente 4xx) de la aplicación.

Devuelve los recuentos agregados de errores edge de la aplicación durante una ventana de tiempo, agrupados por código de estado, intervalo de tiempo, ruta de solicitud y método HTTP. De forma predeterminada solo se incluyen las respuestas 5xx; pasa `include_4xx=true` para contar también las respuestas 4xx.

<Info>
  Límite de solicitudes con fallo de caché: 15 solicitudes cada 60 segundos por propietario. Devuelve un desglose vacío cuando no hay errores coincidentes o cuando la ventana es anterior a la fecha de creación de la aplicación.
</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 para la ventana de análisis.
</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>

<ParamField query="include_4xx" type="string" placeholder="false">
  Indica si se incluyen las respuestas 4xx junto con los errores 5xx. Acepta `true` o `false`. El valor predeterminado es `false`.
</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="object">
  Desglose agregado de errores para la ventana.

  <Expandable title="Alternar objeto de respuesta">
    <ResponseField name="summary" type="object">
      Totales de alto nivel para la ventana.

      <Expandable title="Alternar objeto summary">
        <ResponseField name="total" type="integer">Número total de respuestas con error en la ventana.</ResponseField>

        <ResponseField name="by_class" type="object">
          Totales divididos por clase de estado HTTP.

          <Expandable title="Alternar objeto by_class">
            <ResponseField name="4xx" type="integer">Total de respuestas 4xx (solo se rellena cuando `include_4xx=true`).</ResponseField>
            <ResponseField name="5xx" type="integer">Total de respuestas 5xx.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_status" type="array">
      Número de solicitudes agrupadas por cada código de estado HTTP individual observado.

      <Expandable title="Alternar elemento by_status">
        <ResponseField name="status" type="integer">Código de estado HTTP (p. ej. `502`, `504`).</ResponseField>
        <ResponseField name="requests" type="integer">Total de solicitudes que devolvieron este código de estado.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="timeseries" type="array">
      Recuentos por intervalo de tiempo a lo largo de la ventana de análisis.

      <Expandable title="Alternar elemento timeseries">
        <ResponseField name="date" type="string">Marca de tiempo de inicio del intervalo en formato ISO 8601.</ResponseField>
        <ResponseField name="buckets" type="object">Objeto indexado por código de estado HTTP con el recuento observado en este intervalo.</ResponseField>
        <ResponseField name="total" type="integer">Total de errores observados en este intervalo.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="top_paths" type="array">
      Rutas que produjeron más errores durante la ventana.

      <Expandable title="Alternar elemento top_paths">
        <ResponseField name="path" type="string">Ruta de la solicitud.</ResponseField>
        <ResponseField name="method" type="string">Método HTTP.</ResponseField>
        <ResponseField name="total" type="integer">Total de errores para esta ruta/método.</ResponseField>
        <ResponseField name="by_status" type="object">Recuentos por código de estado HTTP observado para esta ruta/método.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="by_method" type="array">
      Totales de errores agregados agrupados por método HTTP.

      <Expandable title="Alternar elemento by_method">
        <ResponseField name="method" type="string">Método HTTP.</ResponseField>
        <ResponseField name="total" type="integer">Total de errores para este método.</ResponseField>
        <ResponseField name="by_status" type="object">Recuentos por código de estado HTTP observado para este método.</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>
