Errores de red - Square Cloud

GET

apps

{app_id}

network

errors

Errores de red

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.

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.

string

requerido

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

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 pagos, 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 fue exitosa, 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.
`UNABLE_TO_FETCH_ERRORS`	500	No se pudieron obtener los datos de errores del proveedor de borde.

Rendimiento de redObtén los percentiles de latencia del edge y del origen con desgloses por país, colo y ruta para la aplicación.

Errores de red

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

​Parámetros

​Respuesta

​Errores comunes

Parámetros

Respuesta

Errores comunes