Garantías de uptime
| Plan | Uptime objetivo | Compensación con créditos por incumplimiento |
|---|---|---|
| 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 | por contrato, SLA escrito |
El uptime se calcula por mes calendario basado en la respuesta https://api.astroway.info/v1/health
con estado HTTP 200 dentro de 1,000 ms. Las tareas de mantenimiento planificadas (anunciadas con al menos 48 horas
de antelación a través de la página de estado) no se incluyen en el cálculo.
Retrasos objetivo
Se miden en api.astroway.info/v1/* desde una región, solo el tiempo de computación del servidor
(sin incluir cliente y 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 legal: los números reales son de muestreo interno del monitoreo api-calc, el dashboard público de producción-telemetry está en el roadmap. Ten en cuenta: p99 = los extremos más altos, por lo que el tiempo es significativamente mayor que p50.
Endpoints complejos
Agregados 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 inherentemente de larga duración y no están sujetos a SLA de retrasos.
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 | Solicitudes / 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 | personalizado | sin límite |
El sandbox público (POST /v1/public/chart) está limitado por IP - 30 solicitudes / hora,
sin clave de API.
Identificación de solicitud
Cada respuesta contiene el encabezado X-Request-Id (UUID). Añádelo cuando
reportes un incidente - guardamos los logs de acceso durante 30 días y con un solo
request-id podemos reproducir completamente tu llamada.
En 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 solicitudes fallan / fallo regional | confirmación en 15 min |
| SEV-2 | Fallo de endpoint individual o >5% de errores | confirmación en 1 hora |
| SEV-3 | Retraso degradado (p95 > 2× objetivo) | mismo día hábil |
| SEV-4 | Cosmético / problema de un solo cliente | siguiente día hábil |
Reporta incidentes en support@astroway.info con request-id. Para SEV-1
también revisa la página de estado.
Control de versiones y deprecación
- Los endpoints viven bajo
/v1/y permanecen compatibles hacia atrás dentro de la versión principal. - Los cambios importantes se publican bajo
/v2/, y/v1/continúa funcionando ≥ 12 meses. - Agregar campos no se considera un cambio importante; los clientes deben ignorar campos desconocidos.
- La deprecación se anuncia en el changelog y se envía a los propietarios de cuentas por correo electrónico con al menos 90 días de antelación.
Canales de soporte
| Plan | Canal | Respuesta |
|---|---|---|
| Free | GitHub issues, foro comunitario | mejor esfuerzo |
| Starter | support@astroway.info | ≤ 1 día hábil |
| Pro | email + cola prioritaria | ≤ 4 horas hábiles |
| Enterprise | Slack / PagerDuty dedicado | según contrato |