Obtener desglose de errores del edge

GET

apps

{app_id}

network

errors

Obtener desglose de errores del edge

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/errors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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 }
      }
    ]
  }
}

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.

Los fallos de caché comparten un único límite de 20 solicitudes cada 60 segundos por propietario de la aplicación, entre los endpoints de analítica, errores, registros y rendimiento. Las respuestas en caché no cuentan. En periodos de alta demanda en toda la plataforma, el endpoint puede devolver en su lugar los datos en caché más recientes para la ventana solicitada. 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.

string

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Requiere una clave de API con el scope apps:read. Dado que los errores 4xx incluyen solicitudes causadas por el cliente, como sondeos de escáneres y enlaces expirados, se excluyen de forma predeterminada; habilita include_4xx=true solo cuando necesites específicamente ese ruido, por ejemplo al auditar tráfico de bots. Los códigos 5xx reflejan problemas en el borde o en la propia aplicación, por lo que siempre se incluyen. Este endpoint está disponible en todos los planes, igual que Analítica de red. Si necesitas detalle por solicitud en lugar de conteos agregados, consulta Registros de red (solo Pro y Enterprise). Para latencia en lugar de tasa de errores, consulta Rendimiento de red.

Parámetros

string

requerido

El ID de la aplicación. Puedes encontrarlo en la URL del panel de tu aplicación.

string

requerido

Marca de tiempo de inicio en ISO 8601 para la ventana de análisis.

string

requerido

Marca de tiempo de fin en ISO 8601. Debe ser posterior a start.

string

Indica si se incluyen las respuestas 4xx junto con los errores 5xx. Acepta true o false. El valor predeterminado es false.

Respuesta

string

Indica si la llamada fue exitosa: success si lo fue, error si no.

object

Desglose agregado de errores para la ventana.

Mostrar Alternar objeto de respuesta

object

Totales de alto nivel para la ventana.

Mostrar Alternar objeto summary

integer

Número total de respuestas con error en la ventana.

object

Totales divididos por clase de estado HTTP.

Mostrar Alternar objeto by_class

integer

Total de respuestas 4xx (solo se rellena cuando include_4xx=true).

integer

Total de respuestas 5xx.

array

Número de solicitudes agrupadas por cada código de estado HTTP individual observado.

Mostrar Alternar elemento by_status

integer

Código de estado HTTP (p. ej. 502, 504).

integer

Total de solicitudes que devolvieron este código de estado.

array

Recuentos por intervalo de tiempo a lo largo de la ventana de análisis.

Mostrar Alternar elemento timeseries

string

Marca de tiempo de inicio del intervalo en formato ISO 8601.

object

Objeto indexado por código de estado HTTP con el recuento observado en este intervalo.

integer

Total de errores observados en este intervalo.

array

Rutas que produjeron más errores durante la ventana.

Mostrar Alternar elemento top_paths

string

Ruta de la solicitud.

string

Método HTTP.

integer

Total de errores para esta ruta/método.

object

Recuentos por código de estado HTTP observado para esta ruta/método.

array

Totales de errores agregados agrupados por método HTTP.

Mostrar Alternar elemento by_method

string

Método HTTP.

integer

Total de errores para este método.

object

Recuentos por código de estado HTTP observado para este método.

{
  "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 }
      }
    ]
  }
}

Errores comunes

Código	HTTP	Significado
`INVALID_TIME_RANGE`	400	Falta `start`/`end`, están mal formados, o invierten el rango de tiempo.
`RATE_LIMITED`	429	Se alcanzó el límite compartido de fallos de caché. Espera y vuelve a intentarlo.
`UNABLE_TO_FETCH_ERRORS`	500	No se pudieron obtener los datos de errores del proveedor de borde.
`ANALYTICS_BUSY`	503	La analítica de borde está ocupada temporalmente. Vuelve a intentarlo en un minuto.

Relacionado

CLI: squarecloud app network errors
SDKs: api.apps.network.errors() (JavaScript), client.apps.network.errors() (Python), c.Apps.Network.Errors() (Go)

Obtener desglose de errores del edge

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
  --header 'Authorization: <authorization>'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

headers = {"Authorization": "<authorization>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/errors', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/errors",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "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 }
      }
    ]
  }
}

Primeros pasos

Cuenta

Aplicaciones

Bases de datos

Workspaces

IA

Obtener desglose de errores del edge

Parámetros

Respuesta

Errores comunes

Relacionado

​Parámetros

​Respuesta

​Errores comunes

​Relacionado

Parámetros

Respuesta

Errores comunes

Relacionado