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

Garantias de uptime

Plano	Uptime alvo	Compensação em créditos em caso de violação
Gratuito	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 % + personalizado	por contrato, SLA escrito

O uptime é calculado por mês calendário através da resposta https://api.astroway.info/v1/health com status HTTP 200 em 1 000 ms. Trabalhos planeados (anunciados com pelo menos 48 horas de antecedência através da página de status) não são incluídos no cálculo.

Latências alvo

São medidas em api.astroway.info/v1/* de uma região, apenas o tempo de processamento do servidor (sem incluir o cliente e a 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 uma amostragem interna do monitoramento api-calc, o dashboard de telemetria de produção público está no roadmap. Note-se: p99 = maiores extremos, por isso o tempo é significativamente maior que p50.

Endpoints pesados

Agregados 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

POST /v1/rectification (até 120 s) e POST /v1/rectification/trutine (até 15 s) são por natureza longos e não estão sujeitos a SLAs de latência. Eles respeitam o cabeçalho Request-Timeout até 180 s.

Limites de taxa

Limite suave por chave em rateLimitMiddleware, retorna HTTP 429 com cabeçalho Retry-After.

Plano	Pedidos / minuto	Orçamento mensal de créditos
Gratuito	10	10 000
Indie	30	50 000
Starter	120	200 000
Pro	400	800 000
Business	1 000	3 500 000
Enterprise	personalizado	sem limite

O sandbox público (POST /v1/public/chart) está limitado por IP - 30 pedidos / hora, sem chave de API.

Identificação do pedido

Cada resposta contém o cabeçalho X-Request-Id (UUID). Adicione-o quando relatar um incidente - guardamos logs de acesso por 30 dias e com apenas um request-id podemos reproduzir completamente a sua chamada.

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 caem / falha regional	confirmação em 15 min
SEV-2	Falha de um endpoint específico ou >5 % de erros	confirmação em 1 hora
SEV-3	Latência degradada (p95 > 2× o alvo)	no mesmo dia útil
SEV-4	Cosmético / problema de um único cliente	no dia útil seguinte

Relate incidentes para support@astroway.info com request-id. Para SEV-1 verifique também a página de status.

Versionamento e deprecation

Os endpoints vivem em /v1/ e permanecem compatíveis com versões anteriores dentro da versão principal.
Mudanças de breaking são lançadas em /v2/, e /v1/ continua a funcionar ≥ 12 meses.
Adição de campos não é considerada breaking; os clientes devem ignorar campos desconhecidos.
Deprecation é anunciado no changelog e enviado por email aos proprietários de contas com pelo menos 90 dias de antecedência.

Canais de suporte

Plano	Canal	Resposta
Gratuito	GitHub issues, community forum	best effort
Starter	`support@astroway.info`	≤ 1 dia útil
Pro	email + fila prioritária	≤ 4 horas úteis
Enterprise	Slack dedicado / PagerDuty	por contrato

SLA 99.9% uptime