Catálogo AstroWay - já são 865 endpoints em 57 grupos. A esta escala, a principal questão do integrador não é “se a cobertura será suficiente”, mas “como não te perderes”. Este artigo é um mapa: como o catálogo está dividido em domínios e como encontrar o que precisas em menos de um minuto.
Um padrão para todas as chamadas
Seção intitulada “Um padrão para todas as chamadas”Independentemente do domínio, cada endpoint de cálculo tem a mesma forma:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonO corpo - JSON com os dados de nascimento (data, hora, coordenadas) ou parâmetros específicos da técnica. A resposta - sempre { "ok": true, "data": {...} } ou { "ok": false, "error": {...} }. Nenhum GraphQL, nenhum auth-flow separado por domínio: uma chave no cabeçalho X-Api-Key, um formato de resposta.
Isto significa que a camada que tu escreves para o mapa natal serve também para BaZi e para runas - apenas o caminho e o esquema do corpo mudam.
Domínios do catálogo
Seção intitulada “Domínios do catálogo”O catálogo está agrupado em grandes domínios. Eis o mapa com contadores reais (os números são retirados do manifesto em cada build, por isso aqui estão sempre atualizados):
| Domínio | Endpoints | O que há dentro |
|---|---|---|
| Astrologia ocidental | 186 | Mapa natal, aspetos, dignidades, prognósticos (trânsitos, progressões, direções), horary, 4 escolas elínticas, psicologia moderna, evolutiva, cosmobiologia |
| Védica | 230 | Maior domínio: nakshatras, dashas, cartas divisionais (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodygraph, canais, portas, tipo/perfil/autoridade, cruz de encarnação |
| Tarô | 71 | Três baralhos: Rider‑Waite‑Smith, Marseille, Lenormand - spreads, significados, combinações |
| Numerologia | 55 | 5 sistemas com 10 cálculos cada (pitagórica, caldeia, duas cabalísticas, védica) |
| Chinês + Maia | 55 | BaZi (quatro pilares), Zi Wei Dou Shu, zodíaco chinês e feng‑shui, calendários Maia |
| Adivinhação | 40 | Geomancia (Agrippa), runas do Grande Futark, quiromancia (Cheiro), I Ching |
| Nichos aplicados | 53 | Wellness, astrologia animal, negócios, finanças, familiar |
| Relatórios | 29 | Interpretações prontas (natal, sinastria), em HTML/PDF, com branding white‑label |
| Render | 14 | Rodas de cartas SVG/PNG, bodygraph, anéis de trânsito - sem frontend próprio |
| Ferramentas Dev | 47 | Webhooks, streaming em tempo real, widgets incorporáveis, white‑label |
O resto - interpretações AI, horóscopos, endpoints de referência (signos, planetas, aspetos) e sistémicos (health, usage, openapi).
Védica - história à parte
Seção intitulada “Védica - história à parte”230 endpoints védicos - são mais que toda a parte ocidental. A razão é simples: a tradição védica é mais formalizada. Onde a astrologia ocidental tem um conjunto de casas, a védica tem 16 cartas divisionais (varga), várias sistemas dasha, dezenas de yogas com regras claras. Cada um disso é um endpoint com resultado determinado.
Se tu estiveres a construir para o mercado indiano, isto é o núcleo do produto, não um extra.
Precisão por trás de tudo isto
Seção intitulada “Precisão por trás de tudo isto”Independentemente da exotismo da técnica, as posições planetárias são calculadas por um único núcleo na Swiss Ephemeris. O mesmo núcleo funciona tanto na nossa aplicação como na API - uma única base de código, sem divergências. Os endpoints de cálculo estão cobertos por 888 testes snapshot, que em cada PR são comparados com fontes de referência. Mais detalhes sobre isto numa artigo separado sobre precisão CI.
Como encontrar o que precisas
Seção intitulada “Como encontrar o que precisas”Três caminhos, do mais rápido:
- OpenAPI‑guia - /docs/api/ é gerado diretamente a partir da especificação de produção
openapi.json. Os grupos na barra lateral = domínios acima. Cada endpoint tem o esquema do corpo, um exemplo e o botão “experimentar”. - Catálogo MCP - se tu estiveres no Claude ou no Cursor, todo o catálogo está disponível como um conjunto de ferramentas via
mcp.astroway.info. O agente encontra o endpoint necessário por descrição. - Pesquisa por especificação -
curl https://api.astroway.info/v1/openapi.jsondevolve o contrato completo legível por máquina. Útil para gerar código do teu próprio cliente.
Começar
Seção intitulada “Começar”A chave em dashboard/sign-up dá 10 000 créditos por mês - suficiente para percorrer dezenas de domínios e perceber o que te interessa. Não precisas estudar o catálogo inteiro: pega no teu domínio, e o resto esperará até precisares.
Posições ao segundo de arco em 4 linhas de código.
Chave gratuita sem cartão. 5 000 chamadas por mês até o primeiro pagamento.