FAQ answers

Geral

O que é a AstroWay API?

API HTTP profissional para cálculos astrológicos. 771 endpoint baseado no Swiss Ephemeris: cartas natais, sinastria, progressões, direções, trânsitos, Human Design, astrocartografia, retificação, interpretações AI. Todos os cálculos são no servidor – sem dependências no lado do cliente.

Para quem é esta API?

Para desenvolvedores que constroem aplicações astrológicas (web/mobile), empresas de IA que adicionam funcionalidades astrológicas, astrólogos profissionais com scripts, e investigadores que precisam de acesso programático aos cálculos.

Qual a precisão dos cálculos?

Swiss Ephemeris fornece precisão das posições planetárias até ±1 segundo de arco, cúspides das casas até ±1 minuto de arco. Os resultados foram verificados contra Astrodienst (Astro.com), Solar Fire, Zet 9 e Kepler. Deriva sub-arcsecond vs ephemeris NASA JPL e NASA 5-Millennium Eclipse Catalog.

Como a AstroWay compara‑se com Astro.com ou Solar Fire?

Motor idêntico Swiss Ephemeris – o mesmo que está em Solar Fire ($495 licença), Kepler ($995), Astro Gold ($29.99/mês) e Astrodienst (Astro.com). Validado contra ephemeris NASA JPL e referência oficial swetest da Astrodienst. Deriva sub-arcsecond (≤0.1″) nas posições planetárias, ≤1 minuto nos eclipses. Diferença: AstroWay – REST API a partir de $5/mês em vez de licença única ou GUI de desktop.

Que sistemas de casas são suportados?

15 sistemas: Placidus (padrão), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski‑Pisa, Hindu Bhava, APC e Equal do MC. Passa o código correspondente no parâmetro houseSystem.

Créditos e pagamento

Como funciona o sistema de créditos?

Cada endpoint tem um custo fixo em créditos (de 10 a 500), dependendo da complexidade do cálculo. Lookup simples – 10, carta natal – 20, sinastria – 50, retificação – 500. Tabela completa – na página Tarifas.

Existe um plano gratuito?

Sim. O plano Free oferece 10 000 créditos/mês, 10 req/min. Sem necessidade de inserir cartão. Suficiente para avaliar o produto e prototipar.

O que acontece quando os créditos acabam?

No Free – as solicitações são bloqueadas até ao próximo mês (429 CREDITS_EXHAUSTED). Nos planos Indie/Starter/Pro/Business – entra em vigor o overage: $5 / $3 / $2 por 10 000 créditos adicionais.

As solicitações idênticas são armazenadas em cache?

Sim. Input idêntico dentro de 5 minutos é devolvido a partir do cache sem consumir créditos. Confirmado pelo cabeçalho X-Cache: HIT.

É possível comprar créditos sem subscrição?

Ainda não. A subscrição fornece um orçamento previsível e um rate limit melhor. O modelo pay‑as‑you‑go está planeado.

Técnico

Que SDKs estão disponíveis?

• MCP server ✅ lançado: npx -y @astroway/mcp: expõe todos os 771+ endpoints como ferramentas para Claude Desktop, Cursor, GPT e outros agentes de IA compatíveis com MCP
• TypeScript SDK ✅ lançado: npm install @astroway/sdk: tipos + autocomplete com OpenAPI 3.1, retry + idempotency, erros estilo Stainless
• Python SDK ✅ lançado: pip install astroway: sync Astroway + async AsyncAstroway, baseado em httpx, tipado PEP 561
• PHP SDK ✅ lançado: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, middleware de retry
• Go / Ruby / Rust 📋 planeado: subscreve‑te à notificação por email na página de cada SDK (/sdk/<language>/)

O contrato da API – REST + JSON padrão, portanto qualquer cliente HTTP funciona sem SDK. A coleção Postman e a spec OpenAPI 3.1 estão disponíveis publicamente.

Existe modo sandbox?

Sim. Chaves aw_test_* não consomem créditos e devolvem os mesmos resultados. Ideal para desenvolvimento e testes.

Qual o rate limit?

Depende do plano: Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1 000 req/min. Ao exceder – 429 com o cabeçalho Retry-After.

É suportado zodíaco sideral?

Sim. Passa "zodiacType": "sidereal" e opcionalmente "ayanamsaId" (padrão – Lahiri). Funciona com todos os endpoints.

O que são os endpoints de Human Design?

12 endpoints para cálculo de Human Design: tipo, estratégia, autoridade, perfil, definição, cruz de encarnação, canais, centros, Dream Rave, Hologenetic Profile, Penta (dinâmica de grupo), sensibilidade temporal. A cobertura mais profunda de HD entre APIs comerciais.

Segurança e privacidade

Os dados das solicitações são armazenados?

A API funciona stateless – os dados de data/hora/coordenadas de nascimento não são guardados após o processamento da solicitação. Apenas metadados são registados: key_id, endpoint, timestamp, latency, créditos. Nenhum dado pessoal.

A API cumpre os requisitos do GDPR?

Sim. Os dados não são armazenados. Para utilizadores da UE: nenhuma processamento de PII, nenhum profiling, nenhum cookie. A API key está vinculada à conta, não ao utilizador final.

As interpretações AI são seguras?

Endpoints AI (/interpret/*, /horoscope/*) têm guardrails de segurança incorporados: proibição de conselhos médicos, jurídicos ou financeiros. Cada resposta inclui disclaimer. Registo completo de auditoria – para conformidade empresarial.

Suporte

Como obter ajuda?

Depende do plano: Free – comunidade, Indie – email (48 h), Starter – email (24 h), Pro – email (4 h), Business – email + Slack (1 h), Enterprise – gestor dedicado no Slack. Contactos – na página Contactos.

Existe SLA?

Indie: 99 % uptime. Starter e Pro: 99.9 % uptime. Business: 99.95 % uptime. Enterprise: SLA custom com garantias financeiras.

Nomes semelhantes

O AstroWay API (astroway.info) está ligado à subscrição “Astroway” da astroway.life?

Não. astroway.info e api.astroway.info são uma empresa separada e independente. Fornecemos API astrológica para desenvolvedores (api.astroway.info), aplicação para utilizadores finais (app.astroway.info) e consultas de astrólogo. Não temos qualquer ligação à subscrição de astrologia para consumidores que é anunciada e cobrada sob o nome “Astroway” através de astroway.life (e‑mails de no-reply@astroway.life, persona “Celeste”, na declaração bancária – “Astroway”). O operador desta subscrição é TrafficLeader OÜ (Estónia, também traffic-leader.com); o bilhete associado SKYREAD.PRO é ABCMobile OÜ (Estónia). Apenas o nome soa semelhante – são empresas diferentes.

Estou a ser cobrado pela “Astroway” – como cancelar a subscrição e obter reembolso?

Se estás a ser cobrado pela subscrição “Astroway” (e‑mails de no-reply@astroway.life, na declaração bancária – “Astroway”), trata‑se de outra empresa, astroway.life, e não de nós. Não temos acesso à tua conta ou aos pagamentos neste serviço, portanto não podemos cancelá‑los nem reembolsá‑los. Como proceder:

1. Responde diretamente ao e‑mail de no-reply@astroway.life e usa a ligação “unsubscribe / cancel” no rodapé.
2. Se não houver resposta: contacta o teu banco ou a entidade emissora do cartão (pagamento na declaração – “Astroway”; comerciante – TrafficLeader OÜ ou ABCMobile OÜ / SKYREAD.PRO, Estónia) e solicita o bloqueio de novas cobranças ou um chargeback.