Skip to main content
Gli endpoint di questa pagina si applicano solo alle applicazioni sito web — app con un dominio web. Chiamarli su un’applicazione non web fallisce.

Dominio personalizzato

api.SetApplicationCustomDomain(appID, domain) imposta il dominio personalizzato associato al sito web.

Record DNS

Dopo aver collegato un dominio personalizzato devi configurare il DNS presso il tuo registrar. api.GetApplicationDNS(appID) restituisce i record da creare come []squarecloud.DNSRecord.

Analytics

api.GetApplicationAnalytics(appID, start, end) restituisce le analytics edge aggregate per la finestra indicata come squarecloud.NetworkAnalytics. La finestra è obbligatoria e la retention massima è di 7 giorni.
La risposta contiene serie temporali a 15 minuti (Visits, Countries, Devices, OS, Browsers, Protocols, Methods, Paths, Referers, Providers) e bucket sull’intera finestra (IPs, StatusCodes, Bots, ContentTypes).
Per una finestra interamente precedente alla creazione dell’applicazione, l’API restituisce un oggetto vuoto — ogni slice della risposta è nil. Controlla le lunghezze prima di indicizzare.

Filtri di drill-down

Oltre alla finestra, l’endpoint accetta filtri opzionali come parametri di query — passali con rest.WithQueryParam. Ogni filtro restringe contemporaneamente ogni ripartizione della risposta:

Tracciamento degli errori

api.GetApplicationNetworkErrors(appID, start, end) restituisce la ripartizione degli errori edge. Per impostazione predefinita sono inclusi solo gli errori 5xx — aggiungi include_4xx=true per includere i 4xx.

Log per richiesta

api.GetApplicationNetworkLogs(appID, start, end) restituisce i log edge per singola richiesta.
I log per richiesta richiedono un piano Pro o superiore.

Percentili di latenza

api.GetApplicationNetworkPerformance(appID, start, end) restituisce le latenze p50 / p95 / p99 per i livelli edge e origin.
Le metriche di performance richiedono un piano Pro o superiore.

Svuotare la cache edge

api.PurgeApplicationCache(appID) invalida l’intera cache edge per i domini dell’applicazione.

Domini e load balancer a livello di account

Questi due metodi operano su tutte le applicazioni dell’account, non su un singolo sito web.

Elencare tutti i domini

api.GetApplicationDomains() restituisce ogni dominio configurato tra tutte le applicazioni dell’account come []squarecloud.AppDomain. I domini personalizzati sono elencati per primi; le applicazioni senza dominio web vengono omesse.

Load balancer

api.GetLoadBalancers() raggruppa le applicazioni che condividono un dominio personalizzato, restituendo un squarecloud.LoadBalancers.
Un gruppo con 2 o più app è un load balancer attivo: il traffico viene bilanciato all’edge con failover automatico quando una delle app è offline. Limit è il numero massimo di applicazioni che possono condividere un dominio con il piano dell’account: 2 (Standard), 5 (Pro), 10 (Enterprise).