Skip to main content
Os endpoints desta página se aplicam apenas a aplicações website — apps com domínio web. Chamá-los em uma aplicação que não é web falha.

Domínio customizado

api.SetApplicationCustomDomain(appID, domain) define o domínio customizado vinculado ao site.

Registros DNS

Depois de vincular um domínio customizado, configure o DNS no seu registrador. api.GetApplicationDNS(appID) retorna os registros a criar como um []squarecloud.DNSRecord.

Analytics

api.GetApplicationAnalytics(appID, start, end) retorna analytics agregados da edge para a janela informada como um squarecloud.NetworkAnalytics. A janela é obrigatória, e a retenção máxima é de 7 dias.
A resposta traz séries temporais de 15 minutos (Visits, Countries, Devices, OS, Browsers, Protocols, Methods, Paths, Referers, Providers) e buckets de janela inteira (IPs, StatusCodes, Bots, ContentTypes).
Para uma janela inteiramente anterior à criação da aplicação, a API retorna um objeto vazio — todos os slices da resposta são nil. Verifique os tamanhos antes de indexar.

Filtros de drill-down

Além da janela, o endpoint aceita filtros opcionais como query parameters — passe-os com rest.WithQueryParam. Cada filtro restringe todos os breakdowns da resposta de uma vez:

Monitoramento de erros

api.GetApplicationNetworkErrors(appID, start, end) retorna o breakdown de erros da edge. Por padrão, apenas erros 5xx são incluídos — adicione include_4xx=true para incluir os 4xx.

Logs por requisição

api.GetApplicationNetworkLogs(appID, start, end) retorna os logs por requisição da edge.
Logs por requisição exigem o plano Pro ou superior.

Percentis de latência

api.GetApplicationNetworkPerformance(appID, start, end) retorna as latências p50 / p95 / p99 para as camadas edge e origin.
Métricas de performance exigem o plano Pro ou superior.

Limpando o cache da edge

api.PurgeApplicationCache(appID) invalida o cache inteiro da edge para os domínios da aplicação.

Domínios e load balancers de toda a conta

Esses dois métodos operam sobre todas as aplicações da conta, não apenas um único site.

Listando todos os domínios

api.GetApplicationDomains() retorna todos os domínios configurados em todas as aplicações da conta como um []squarecloud.AppDomain. Domínios customizados são listados primeiro; aplicações sem domínio web são omitidas.

Load balancers

api.GetLoadBalancers() agrupa aplicações que compartilham um domínio customizado, retornando um squarecloud.LoadBalancers.
Um grupo com 2 ou mais apps é um load balancer ativo: o tráfego é balanceado na edge com failover automático quando um dos apps está offline. Limit é o número máximo de aplicações que podem compartilhar um domínio no plano da conta: 2 (Standard), 5 (Pro), 10 (Enterprise).