Acuerdo de nivel de servicio (SLA)

Garantías de uptime

Plan	Uptime objetivo	Compensación en créditos al incumplir
Free	Sin garantías	Sin compensación
Indie	99 %	5 % del pago mensual por cada 0.1 %
Starter	99.9 %	10 % del pago mensual por cada 0.1 %
Pro	99.9 %	25 % del pago mensual por cada 0.1 %
Business	99.95 %	50 % del pago mensual por cada 0.1 %
Enterprise	99.99 % + custom	Según contrato, SLA por escrito

El uptime se calcula por mes calendario según la respuesta de https://api.astroway.info/v1/health con estado HTTP 200 en menos de 1 000 ms. Los trabajos programados (anunciados con al menos 48 horas de antelación en la página de estado) no se incluyen en el cálculo.

Latencias objetivo

Se miden en api.astroway.info/v1/* desde una sola región, solo el tiempo de cálculo del servidor (sin incluir cliente ni red). Publicamos un informe trimestral completo en la página de estado.

Endpoints estándar

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return y similares.

Métrica	Objetivo	Real (muestreo interno, 2026-05-09)
p50	< 100 ms	~80 ms
p95	< 500 ms	~280 ms
p99	< 1 s	~640 ms

Aviso: Los números reales son un muestreo interno del monitoreo de api-calc. El panel público de telemetría de producción está en la hoja de ruta. Ten en cuenta que p99 = valores extremos más altos, por lo que el tiempo es significativamente mayor que p50.

Endpoints pesados

Agregaciones de varios días: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

Métrica	Objetivo	Real (2026-04-15)
p95	< 2 s	1.9 s (moon-aspects, 30d)
p99	< 4 s	1.9 s

Rectificación

POST /v1/rectification (hasta 120 s) y POST /v1/rectification/trutine (hasta 15 s) son procesos de larga duración por naturaleza y no están cubiertos por el SLA de latencia. Respetan el encabezado Request-Timeout hasta 180 s.

Límites de frecuencia

Límite suave por clave en rateLimitMiddleware, devuelve HTTP 429 con el encabezado Retry-After.

Plan	Peticiones / minuto	Presupuesto mensual de créditos
Free	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	custom	Sin límite

El sandbox público (POST /v1/public/chart) tiene un límite por IP de 30 peticiones / hora, sin clave de API.

Identificación de peticiones

Cada respuesta incluye el encabezado X-Request-Id (UUID). Inclúyelo al reportar un incidente: guardamos los logs de acceso durante 30 días y podemos reconstruir tu llamada solo con el request-id.

En errores HTTP 5xx, el mismo identificador se duplica en el cuerpo de la respuesta:

{
  "ok": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f"
  }
}

Respuesta a incidentes

Nivel	Definición	SLA de respuesta
SEV-1	Todas las peticiones fallan / fallo regional	Confirmación en 15 min
SEV-2	Fallo de un endpoint o >5 % de errores	Confirmación en 1 hora
SEV-3	Latencia degradada (p95 > 2× objetivo)	Mismo día laborable
SEV-4	Problema cosmético / de un solo cliente	Día laborable siguiente

Reporta incidentes a support@astroway.info incluyendo el request-id. Para SEV-1, verifica también la página de estado.

Versionado y deprecación

Los endpoints viven bajo /v1/ y permanecen compatibles hacia atrás dentro de la misma versión principal.
Los cambios disruptivos se lanzan bajo /v2/, mientras que /v1/ sigue funcionando ≥ 12 meses.
Añadir campos no se considera un cambio disruptivo; los clientes deben ignorar campos desconocidos.
La deprecación se anuncia en el changelog y se envía por email a los dueños de cuentas con al menos 90 días de antelación.

Canales de soporte

Plan	Canal	Respuesta
Free	Issues de GitHub, foro comunitario	Mejor esfuerzo
Starter	`support@astroway.info`	≤ 1 día laborable
Pro	email + cola prioritaria	≤ 4 horas laborables
Enterprise	Slack / PagerDuty dedicado	Según contrato

SLA 99.9% uptime