Skip to main content
Los endpoints de esta página aplican solo a aplicaciones de sitio web — apps con un dominio web. Llamarlos en una aplicación que no es web falla.

Dominio personalizado

api.SetApplicationCustomDomain(appID, domain) establece el dominio personalizado vinculado al sitio web.

Registros DNS

Después de vincular un dominio personalizado necesitas configurar el DNS en tu registrador. api.GetApplicationDNS(appID) devuelve los registros a crear como un []squarecloud.DNSRecord.

Analíticas

api.GetApplicationAnalytics(appID, start, end) devuelve las analíticas agregadas del edge para la ventana dada como un squarecloud.NetworkAnalytics. La ventana es obligatoria y la retención máxima es de 7 días.
La respuesta contiene series temporales de 15 minutos (Visits, Countries, Devices, OS, Browsers, Protocols, Methods, Paths, Referers, Providers) y buckets de la ventana completa (IPs, StatusCodes, Bots, ContentTypes).
Para una ventana completamente anterior a la creación de la aplicación, la API devuelve un objeto vacío — todos los slices de la respuesta son nil. Comprueba las longitudes antes de indexar.

Filtros de detalle

Además de la ventana, el endpoint acepta filtros opcionales como parámetros de query — pásalos con rest.WithQueryParam. Cada filtro acota a la vez todos los desgloses de la respuesta:

Seguimiento de errores

api.GetApplicationNetworkErrors(appID, start, end) devuelve el desglose de errores del edge. Por defecto solo se incluyen los errores 5xx — añade include_4xx=true para incluir los 4xx.

Logs por solicitud

api.GetApplicationNetworkLogs(appID, start, end) devuelve los logs del edge por solicitud.
Los logs por solicitud requieren un plan Pro o superior.

Percentiles de latencia

api.GetApplicationNetworkPerformance(appID, start, end) devuelve las latencias p50 / p95 / p99 de las capas edge y origin.
Las métricas de rendimiento requieren un plan Pro o superior.

Purga de la caché del edge

api.PurgeApplicationCache(appID) invalida toda la caché del edge para los dominios de la aplicación.

Dominios y load balancers a nivel de cuenta

Estos dos métodos operan sobre todas las aplicaciones de la cuenta en lugar de un único sitio web.

Listado de todos los dominios

api.GetApplicationDomains() devuelve todos los dominios configurados en todas las aplicaciones de la cuenta como un []squarecloud.AppDomain. Los dominios personalizados se listan primero; las aplicaciones sin dominio web se omiten.

Load balancers

api.GetLoadBalancers() agrupa las aplicaciones que comparten un dominio personalizado, devolviendo un squarecloud.LoadBalancers.
Un grupo con 2 o más apps es un load balancer activo: el tráfico se balancea en el edge con failover automático cuando una de las apps está fuera de línea. Limit es el número máximo de aplicaciones que pueden compartir un dominio en el plan de la cuenta: 2 (Standard), 5 (Pro), 10 (Enterprise).