Gerais
O que é a API AstroWay?
API HTTP profissional para cálculos astrológicos. 714 endpoints baseados no Swiss Ephemeris (WASM): mapas natals, sinastria, progressões, direções, trânsitos, Human Design, astrocartografia, retificação e interpretações com IA. Todos os cálculos são feitos 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?
O Swiss Ephemeris garante precisão das posições planetárias até ±1 segundo de arco e dos cúspides das casas até ±1 minuto de arco. Os resultados são verificados contra o Astrodienst (Astro.com), Solar Fire, Zet 9 e Kepler. Desvio sub-segundo de arco em comparação com a efeméride do JPL da NASA e o Catálogo de Eclipses de 5 Milênios da NASA.
Como o AstroWay se compara ao Astro.com ou Solar Fire?
Motor idêntico ao Swiss Ephemeris — o mesmo usado no Solar Fire ($495 de licença), Kepler ($995), Astro Gold ($29.99/mês) e Astrodienst (Astro.com). Validado contra a efeméride do JPL da NASA e o teste de referência swetest oficial do Astrodienst. Desvio sub-segundo de arco (≤0.1″) nas posições planetárias e ≤1 minuto nos eclipses. A diferença: o AstroWay é uma API REST a partir de $5/mês, em vez de uma licença única ou interface gráfica desktop.
Quais sistemas de casas são suportados?
15 sistemas: Placidus (padrão), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocêntrico, 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. Consulta simples — 10, mapa natal — 20, sinastria — 50, retificação — 500. A tabela completa está na página Preços.
Existe um plano gratuito?
Sim. O plano Free oferece 10 000 créditos/mês, 10 req/min. Sem necessidade de cartão de crédito. É suficiente para avaliar o produto e prototipar.
O que acontece quando os créditos acabam?
No plano Free, os pedidos são bloqueados até o próximo mês (429 CREDITS_EXHAUSTED). Nos planos Indie/Starter/Pro/Business, é ativado o overage: $5 / $3 / $2 por cada 10 000 créditos adicionais.
Os pedidos iguais são cacheados?
Sim. Inputs idênticos dentro de 5 minutos são retornados do cache sem debitar créditos. Confirmado pelo cabeçalho X-Cache: HIT.
Posso comprar créditos sem assinatura?
Ainda não. A assinatura oferece um orçamento previsível e melhor limite de taxa. Um plano pay-as-you-go está planeado.
Técnico
Quais SDKs estão disponíveis?
- Servidor MCP ✅ lançado:
npx -y @astroway/mcp— expõe todos os 714+ endpoints como ferramentas para o Claude $1, Cursor, GPT e outros agentes de IA compatíveis com MCP - SDK TypeScript ✅ lançado:
npm install @astroway/sdk— tipos + autocompletar com OpenAPI 3.1, retry + idempotência, erros no estilo Stainless - SDK Python ✅ lançado:
pip install astroway—Astrowaysíncrono +AsyncAstrowayassíncrono, baseado nohttpx, tipado PEP 561 - SDK PHP ✅ lançado:
composer require astroway/sdk— PHP 8.1+, Guzzle 7 + PSR-18, middleware de retry - Go / Ruby / Rust 📋 planeado — subscreve para notificação por email na página de cada SDK (
/sdk/<language>/)
O contrato da API é REST + JSON padrão, por isso qualquer cliente HTTP funciona sem SDK. A coleção do Postman e a especificação OpenAPI 3.1 estão disponíveis publicamente.
Existe modo sandbox?
Sim. As chaves aw_test_* não debitam créditos e retornam os mesmos resultados. Ideal para desenvolvimento e testes.
Qual é o limite de taxa?
Depende do plano: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1 000 req/min. Ao exceder, retorna 429 com o cabeçalho Retry-After.
O zodíaco sideral é suportado?
Sim. Passa "zodiacType": "sidereal" e opcionalmente "ayanamsaId" (padrão — Lahiri). Funciona com todos os endpoints.
O que são os endpoints do Human Design?
12 endpoints para cálculos do Human Design: tipo, estratégia, autoridade, perfil, definição, cruzamento de encarnação, canais, centros, Dream Rave, Perfil Hologenético, Penta (dinâmica de grupo) e sensibilidade temporal. A cobertura mais profunda do HD entre as APIs comerciais.
Segurança e Privacidade
Os dados dos pedidos são armazenados?
A API é stateless — dados como data/hora/coordenadas de nascimento não são armazenados após o processamento do pedido. Apenas metadados são registados: key_id, endpoint, timestamp, latency e créditos. Nenhum dado pessoal.
A API está em conformidade com o GDPR?
Sim. Os dados não são armazenados. Para utilizadores da UE: sem processamento de PII, sem perfilização, sem cookies. A chave da API está vinculada à conta, não ao utilizador final.
As interpretações com IA são seguras?
Os endpoints de IA (/interpret/*, /horoscope/*) têm guardrails de segurança integrados: proibição de conselhos médicos, jurídicos ou financeiros. Cada resposta inclui um aviso legal. Trilho de auditoria completo para conformidade empresarial.
Suporte
Como obter ajuda?
Depende do plano: Free — comunidade, Indie — email (48h), Starter — email (24h), Pro — email (4h), Business — email + Slack (1h), Enterprise — gestor dedicado no Slack. Os contactos estão na página Contactos.
Existe SLA?
Indie: 99% de uptime. Starter e Pro: 99.9% de uptime. Business: 99.95% de uptime. Enterprise: SLA personalizado com garantias financeiras.