Analytics del traffico del sito web

GET

apps

{app_id}

network

analytics

Analytics del traffico del sito web

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

import requests

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

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/analytics', 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/analytics",
  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/analytics"

	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/analytics")

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": {
    "visits": [
      { "visits": 1024, "requests": 1247, "bytes": 8421000, "date": "2026-05-21T10:00:00Z" }
    ],
    "countries": [
      { "type": "BR", "visits": 612, "requests": 743, "bytes": 5012000, "date": "2026-05-21T10:00:00Z" }
    ],
    "devices": [
      { "type": "desktop", "visits": 820, "requests": 998, "bytes": 6700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "os": [
      { "type": "Windows", "visits": 540, "requests": 651, "bytes": 4400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "browsers": [
      { "type": "Chrome", "visits": 720, "requests": 870, "bytes": 5800000, "date": "2026-05-21T10:00:00Z" }
    ],
    "protocols": [
      { "type": "HTTP/2", "visits": 900, "requests": 1100, "bytes": 7400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "methods": [
      { "type": "GET", "visits": 850, "requests": 1020, "bytes": 6900000, "date": "2026-05-21T10:00:00Z" }
    ],
    "paths": [
      { "type": "/", "visits": 410, "requests": 498, "bytes": 3320000, "date": "2026-05-21T10:00:00Z" }
    ],
    "referers": [
      { "type": "Direct", "visits": 380, "requests": 462, "bytes": 3100000, "date": "2026-05-21T10:00:00Z" }
    ],
    "providers": [
      { "type": "GOOGLE (15169)", "visits": 210, "requests": 254, "bytes": 1700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "ips": [
      { "type": "203.0.113.45", "visits": 40, "requests": 3120, "bytes": 2100000 }
    ],
    "status_codes": [
      { "type": "200", "visits": 950, "requests": 1180, "bytes": 8100000 }
    ],
    "bots": [
      { "type": "Search Engine Crawler", "visits": 0, "requests": 84, "bytes": 410000 }
    ],
    "content_types": [
      { "type": "json", "visits": 310, "requests": 720, "bytes": 4200000 }
    ]
  }
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope apps:read. Analytics aggrega il traffico edge di Cloudflare per il dominio predefinito squareweb.app dell’applicazione e per qualsiasi dominio personalizzato collegato: numero di richieste, banda, numero di visitatori e suddivisioni per paese, dispositivo, OS, browser, protocollo, metodo, percorso, referer e rete del client. Usalo per costruire dashboard di traffico o individuare pattern insoliti senza dover recuperare i log grezzi delle richieste. I risultati vengono memorizzati nella cache in bucket da 5 minuti, quindi effettuare più volte il polling della stessa finestra è economico. I cache miss condividono un unico limite di 20 richieste ogni 60 secondi per proprietario dell’applicazione, tra gli endpoint analytics, errors, logs e performance. Le risposte memorizzate nella cache non vengono conteggiate. Nei periodi di carico elevato sull’intera piattaforma, l’endpoint può invece restituire i dati più recenti memorizzati nella cache per la finestra richiesta. Il lookback massimo è di 7 giorni e l’inizio effettivo viene limitato alla data di creazione dell’applicazione. A differenza di Log di rete e Prestazioni di Rete, questo endpoint è disponibile su ogni piano, non solo Pro ed Enterprise. Per il traffico incentrato sugli errori invece che sul traffico complessivo, vedi Errori di rete. Per svuotare le risposte edge memorizzate nella cache dopo un deploy, vedi Svuota Cache.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

string

obbligatorio

Timestamp di inizio ISO 8601 per la finestra di analisi. La finestra massima di conservazione è di 7 giorni; l’inizio viene limitato alla data di creazione dell’applicazione.

string

obbligatorio

Timestamp di fine ISO 8601. Deve essere successivo a start.

Filtri di dettaglio

Filtri opzionali che restringono ogni suddivisione al traffico corrispondente. Reinserisci il valore type esatto restituito dalla suddivisione corrispondente in una risposta precedente. I filtri si combinano (AND).

string

Un singolo paese del client (codice a 2 caratteri), come restituito nella suddivisione countries.

string

Un singolo IP del client (corrispondenza IPv4/IPv6 esatta), come restituito nella suddivisione ips.

string

Percorsi di richiesta che iniziano con questo prefisso (es. /api copre /api/*). Massimo 256 caratteri.

string

Un singolo codice di stato della risposta edge (3 cifre), come restituito nella suddivisione status_codes.

string

Un singolo OS del client, come restituito nella suddivisione os.

string

Un singolo browser del client, come restituito nella suddivisione browsers.

string

Un singolo protocollo HTTP, come restituito nella suddivisione protocols.

string

Un singolo host referer, come restituito nella suddivisione referers (Direct = nessun referer).

string

Una singola rete del client, con il valore type esatto restituito dalla suddivisione providers, ad esempio GOOGLE (15169). Funzionano anche un semplice numero ASN o SQUARE-CLOUD-PLATFORM. Qualsiasi altro valore risponde INVALID_FILTER.

string

Un singolo content type della risposta, come restituito nella suddivisione content_types (Unknown = non classificato).

string

Una singola categoria di bot verificato, come restituita nella suddivisione bots (Unverified = traffico regolare non bot).

Risposta

Questa route può inviare una risposta in formato compresso, ottimizzando la trasmissione dei dati.

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

object

Ogni suddivisione è un array di bucket. type identifica la dimensione, visits sono i visitatori unici, requests è il numero di richieste, bytes sono i byte di risposta serviti e date è l’inizio della finestra di 15 minuti. Le suddivisioni ips, status_codes, bots e content_types sono totali sulla finestra (top-N sull’intera finestra) e non contengono il campo date. Restituisce un oggetto vuoto ({}) quando la finestra richiesta inizia prima della data di creazione dell’applicazione.

{
  "status": "success",
  "response": {
    "visits": [
      { "visits": 1024, "requests": 1247, "bytes": 8421000, "date": "2026-05-21T10:00:00Z" }
    ],
    "countries": [
      { "type": "BR", "visits": 612, "requests": 743, "bytes": 5012000, "date": "2026-05-21T10:00:00Z" }
    ],
    "devices": [
      { "type": "desktop", "visits": 820, "requests": 998, "bytes": 6700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "os": [
      { "type": "Windows", "visits": 540, "requests": 651, "bytes": 4400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "browsers": [
      { "type": "Chrome", "visits": 720, "requests": 870, "bytes": 5800000, "date": "2026-05-21T10:00:00Z" }
    ],
    "protocols": [
      { "type": "HTTP/2", "visits": 900, "requests": 1100, "bytes": 7400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "methods": [
      { "type": "GET", "visits": 850, "requests": 1020, "bytes": 6900000, "date": "2026-05-21T10:00:00Z" }
    ],
    "paths": [
      { "type": "/", "visits": 410, "requests": 498, "bytes": 3320000, "date": "2026-05-21T10:00:00Z" }
    ],
    "referers": [
      { "type": "Direct", "visits": 380, "requests": 462, "bytes": 3100000, "date": "2026-05-21T10:00:00Z" }
    ],
    "providers": [
      { "type": "GOOGLE (15169)", "visits": 210, "requests": 254, "bytes": 1700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "ips": [
      { "type": "203.0.113.45", "visits": 40, "requests": 3120, "bytes": 2100000 }
    ],
    "status_codes": [
      { "type": "200", "visits": 950, "requests": 1180, "bytes": 8100000 }
    ],
    "bots": [
      { "type": "Search Engine Crawler", "visits": 0, "requests": 84, "bytes": 410000 }
    ],
    "content_types": [
      { "type": "json", "visits": 310, "requests": 720, "bytes": 4200000 }
    ]
  }
}

Errori comuni

Codice	HTTP	Significato
`INVALID_TIME_RANGE`	400	`start`/`end` mancanti, malformati o con l’intervallo temporale invertito.
`INVALID_FILTER`	400	Un filtro di dettaglio non corrisponde al formato atteso.
`RATE_LIMITED`	429	È stato raggiunto il limite condiviso dei cache miss. Attendi e riprova.
`UNABLE_TO_FETCH_ANALYTICS`	500	Recupero delle analytics dal provider edge non riuscito.
`ANALYTICS_BUSY`	503	Le analytics edge sono temporaneamente sovraccariche. Riprova tra un minuto.

Vedi anche

CLI: squarecloud app network analytics
SDK: api.apps.network.analytics() (JavaScript), client.apps.network.analytics() (Python), c.Apps.Network.Analytics() (Go)

Analytics del traffico del sito web

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

import requests

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

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/analytics', 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/analytics",
  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/analytics"

	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/analytics")

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": {
    "visits": [
      { "visits": 1024, "requests": 1247, "bytes": 8421000, "date": "2026-05-21T10:00:00Z" }
    ],
    "countries": [
      { "type": "BR", "visits": 612, "requests": 743, "bytes": 5012000, "date": "2026-05-21T10:00:00Z" }
    ],
    "devices": [
      { "type": "desktop", "visits": 820, "requests": 998, "bytes": 6700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "os": [
      { "type": "Windows", "visits": 540, "requests": 651, "bytes": 4400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "browsers": [
      { "type": "Chrome", "visits": 720, "requests": 870, "bytes": 5800000, "date": "2026-05-21T10:00:00Z" }
    ],
    "protocols": [
      { "type": "HTTP/2", "visits": 900, "requests": 1100, "bytes": 7400000, "date": "2026-05-21T10:00:00Z" }
    ],
    "methods": [
      { "type": "GET", "visits": 850, "requests": 1020, "bytes": 6900000, "date": "2026-05-21T10:00:00Z" }
    ],
    "paths": [
      { "type": "/", "visits": 410, "requests": 498, "bytes": 3320000, "date": "2026-05-21T10:00:00Z" }
    ],
    "referers": [
      { "type": "Direct", "visits": 380, "requests": 462, "bytes": 3100000, "date": "2026-05-21T10:00:00Z" }
    ],
    "providers": [
      { "type": "GOOGLE (15169)", "visits": 210, "requests": 254, "bytes": 1700000, "date": "2026-05-21T10:00:00Z" }
    ],
    "ips": [
      { "type": "203.0.113.45", "visits": 40, "requests": 3120, "bytes": 2100000 }
    ],
    "status_codes": [
      { "type": "200", "visits": 950, "requests": 1180, "bytes": 8100000 }
    ],
    "bots": [
      { "type": "Search Engine Crawler", "visits": 0, "requests": 84, "bytes": 410000 }
    ],
    "content_types": [
      { "type": "json", "visits": 310, "requests": 720, "bytes": 4200000 }
    ]
  }
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Analytics del traffico del sito web

Parametri

Filtri di dettaglio

Risposta

Errori comuni

Vedi anche

​Parametri

​Filtri di dettaglio

​Risposta

​Errori comuni

​Vedi anche

Parametri

Filtri di dettaglio

Risposta

Errori comuni

Vedi anche