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.
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 conrest.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.
Limit è il numero massimo di applicazioni che possono condividere un dominio con il piano dell’account: 2 (Standard), 5 (Pro), 10 (Enterprise).
