# Visão geral

**AstroWay API** — uma API REST profissional para cálculos astrológicos como serviço.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoints baseados no Swiss Ephemeris (WASM), com cobertura de técnicas que não existem em nenhuma concorrente: harmónicas, cartas draconianas, CCG, setores de Gauquelin, Human Design completo, retificação.

## Para quem é isto

1. **Desenvolvedores de aplicações astrológicas** (web, mobile) que precisam de cálculos precisos e variados sem infraestrutura própria.
2. **Empresas de IA** que integram funcionalidades astrológicas — existe um servidor MCP nativo para Claude, ChatGPT e outros agentes.
3. **Astrólogos profissionais** que constroem as suas próprias ferramentas ou scripts para clientes.
4. **Investigadores** que necessitam de acesso programático a cálculos para estudos estatísticos.
5. **Plataformas de conteúdo** que adicionam funcionalidades astrológicas sobre produtos existentes.

## Para quem **não** é

- Widgets horoscópicos de "signo de hoje" sem controlo — as interpretações e horóscopos (`/interpret/*`, `/horoscope/*`) existem, mas são projetados como API para desenvolvedores, não como widgets prontos.
- Astrologia védica como especialização principal — para projetos Vedic-first (sistemas Dasha, Panchang, KP), Prokerala e VedicAstroAPI são mais fortes. Para astrologia ocidental + Human Design + técnicas raras (retificação, harmónicas, CCG), o AstroWay supera-as. Consulta /compare/.
- Tarot/numerologia — apenas astrologia e Human Design. I-Ching está disponível como endpoint bónus.

## O que torna o AstroWay único

### 1. Técnicas raras em formato de API

| Técnica | Para que serve |
|---|---|
| **Cartas harmónicas** (H2–H180) | Astrologia de investigação (método de John Addey) |
| **Carta draconiana** | Astrologia cármica/da alma |
| **CCG (Cyclo-Carto-Graphy)** | Astrocartografia progressiva — técnica premium de Jim Lewis |
| **Setores de Gauquelin** | Astrologia estatística, uso académico |
| **Progressões terciárias** | Terceiro tipo de progressões — nicho, mas valorizado |
| **Antíscias / contra-antíscias** | Técnica clássica helenística — renascimento de escolas tradicionais |
| **Aspetos paralelos** | Aspetos por declinação — práticas avançadas |
| **Retificação via API** | Correção do tempo de nascimento — valor altíssimo |
| **Ciclos planetários** (conjunções) | Astrologia mundana — eventos mundiais |
| **Índice cíclico de Barbault** | Astrologia mundana |
| **Mínimo de Algol** | Tempos de estrelas fixas — astrologia eletiva |
| **Linhas de espaço local** | Astrologia direcional semelhante ao Feng Shui |
| **Cadeias de disposição** | Grafos de controlo — técnica clássica |
| **Almutem figuris** | Técnica medieval — renascimento tradicional |

### 2. Precisão do Swiss Ephemeris — o mesmo motor usado no Solar Fire ($495), Kepler ($995), Astro Gold

O mesmo Swiss Ephemeris (LGPL) usado por astrólogos profissionais no Solar Fire, Kepler, Astro Gold e Janus há mais de 30 anos — só que em compilação WASM e como REST API, sem margem de revenda intermédia. Precisão:

- Posições planetárias: ±1 segundo de arco vs. efemérides NASA JPL
- Cúspides de casas: ±1 minuto de arco
- Validação contra Zet 9, Solar Fire (efemérides proprietárias), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — discrepâncias dentro dos limites do método (≤0.1″).

### 3. {siteMeta.endpoints} endpoints — cobertura profunda das técnicas ocidentais

{siteMeta.westernCount} endpoints de cálculo de astrologia ocidental (4 escolas: helenística, psicológica moderna, evolutiva, cosmobiologia) + interpretações por IA + Human Design completo. Profundidade em vez de dispersão por dezenas de direções.

## Arquitetura

```
A tua aplicação
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Cálculo e retorno em JSON
```

- Os cálculos são executados **no servidor** — nenhum blob WASM no frontend da tua aplicação, nenhum problema de licenciamento do Swiss Ephemeris.
- O estado é mantido no servidor — cada pedido é autossuficiente. Nenhum vazamento de dados dos clientes.
- As chaves API estão vinculadas ao plano, com limite de rate e saldo diário de créditos. Monitorização através do dashboard.

## Próximos passos

- [Primeiros passos](/getting-started/) — faz o teu primeiro pedido em 5 minutos
- [Autenticação](/authentication/) — como obter e guardar a chave
- [Créditos e limites](/rate-limits-credits/) — como funciona a faturação
- [Documentação da API](/docs/api/) — todos os endpoints com playground interativo