Acordo de nível de serviço (SLA)

Garantias de uptime

Plano	Uptime alvo	Compensação em créditos em caso de violação
Free	sem garantias	sem compensação
Indie	99 %	5 % do pagamento mensal por cada 0,1 %
Starter	99,9 %	10 % do pagamento mensal por cada 0,1 %
Pro	99,9 %	25 % do pagamento mensal por cada 0,1 %
Business	99,95 %	50 % do pagamento mensal por cada 0,1 %
Enterprise	99,99 % + custom	conforme contrato, SLA escrito por escrito

O uptime é calculado por mês civil com base na resposta do endpoint https://api.astroway.info/v1/health com status HTTP 200 em até 1 000 ms. Manutenções programadas (anunciadas com pelo menos 48 horas de antecedência na página de status) não são contabilizadas.

Atrasos alvo

São medidos no api.astroway.info/v1/* a partir de uma região, considerando apenas o tempo de cálculo no servidor (sem incluir tempo de cliente ou de rede). Publicamos um relatório trimestral completo na página de status.

Endpoints padrão

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

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

Aviso: Os números reais são de uma amostragem interna do monitoramento do api-calc. O dashboard público de telemetria de produção está na nossa roadmap. Atenção: p99 = extremos mais altos, por isso o tempo é significativamente maior que o p50.

Endpoints pesados

Agregações de vários dias: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

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

Retificação

Os endpoints POST /v1/rectification (até 120 s) e POST /v1/rectification/trutine (até 15 s) são naturalmente demorados e não estão cobertos pelo SLA de atrasos. Eles respeitam o cabeçalho Request-Timeout até 180 s.

Limitação de taxa

Limitação suave por chave no rateLimitMiddleware, retornando HTTP 429 com o cabeçalho Retry-After.

Plano	Pedidos / minuto	Orçamento mensal 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	sem limite

O sandbox público (POST /v1/public/chart) tem limitação por IP — 30 pedidos / hora, sem necessidade de chave de API.

Identificação de pedido

Toda resposta inclui o cabeçalho X-Request-Id (UUID). Inclui-o ao reportar um incidente — mantemos os logs de acesso por 30 dias e conseguimos reproduzir completamente a tua chamada apenas com o request-id.

Em HTTP 5xx, o mesmo identificador é duplicado no corpo da resposta:

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

Resposta a incidentes

Nível	Definição	SLA de resposta
SEV-1	Todos os pedidos falham / falha regional	confirmação em 15 min
SEV-2	Falha em endpoint específico ou >5 % de erros	confirmação em 1 hora
SEV-3	Atraso degradado (p95 > 2× alvo)	ainda no mesmo dia útil
SEV-4	Problema cosmético / questão de um cliente	no próximo dia útil

Reporta incidentes para support@astroway.info com o request-id. Para SEV-1, verifica também a página de status.

Versionamento e descontinuação

Os endpoints vivem sob /v1/ e permanecem retrocompatíveis dentro da mesma versão principal.
Alterações breaking são lançadas sob /v2/, enquanto /v1/ continua ativo por ≥ 12 meses.
Adição de campos não é considerada breaking; os clientes devem ignorar campos desconhecidos.
A descontinuação é anunciada no changelog e enviada por e-mail aos proprietários de contas com pelo menos 90 dias de antecedência.

Canais de suporte

Plano	Canal	Resposta
Free	Issues do GitHub, fórum da comunidade	best effort
Starter	`support@astroway.info`	≤ 1 dia útil
Pro	e-mail + fila prioritária	≤ 4 horas úteis
Enterprise	Slack dedicado / PagerDuty	conforme contrato

SLA 99.9% uptime