# Aplicativos de Astrologia
Estás a construir uma aplicação astrológica como Co-Star, Sanctuary, The Pattern, Chani ou Costar Compat? A API AstroWay substitui a necessidade de licenciar o Solar Fire ($495) ou de escrever o teu próprio motor de efemérides: {siteMeta.endpoints} endpoints (mapas natals, sinastria, trânsitos, Human Design, interpretações com IA), OpenAPI 3.1 para geração de clientes tipados (TS / Python SDK na roadmap), precisão Swiss Ephemeris — o mesmo motor usado no Astrodienst e Kepler.
## Arquitetura típica
```
Utilizador (browser / mobile)
↓
O teu backend (Node.js / Python / PHP)
↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
↓
Resposta JSON → renderização na tua UI
```
## Endpoints principais para aplicações astrológicas
### MVP (produto mínimo viável)
| Endpoint | Créditos | Para que serve |
|---|---|---|
| `/v1/chart` | 20 | Construção de mapa natal |
| `/v1/synastry` | 50 | Compatibilidade entre duas pessoas |
| `/v1/horoscope/daily` | 20 | Horóscopo diário |
Três endpoints e já tens um produto funcional com mapa natal, compatibilidade e conteúdo diário.
### Produto avançado
| Endpoint | Créditos | Para que serve |
|---|---|---|
| `/v1/transits` | 50 | Trânsitos atuais no mapa natal |
| `/v1/solar-return` | 50 | Mapa solar (anual) |
| `/v1/progressions` | 50 | Progressões secundárias |
| `/v1/interpret/natal` | 50 | Interpretação com IA do mapa natal |
| `/v1/transit-calendar` | 100 | Calendário de eventos de trânsitos |
| `/v1/human-design` | 50 | Mapa de Human Design |
### Funções premium
| Endpoint | Créditos | Para que serve |
|---|---|---|
| `/v1/rectification` | 500 | Correção de hora de nascimento |
| `/v1/acg` | 50 | Astrocartografia (onde viver melhor) |
| `/v1/forecast-calendar` | 100 | Previsão anual em formato heatmap |
| `/v1/group-synastry` | 100 | Compatibilidade em grupo |
## Estimativa de orçamento
### Cenário: 100 DAU (utilizadores ativos diários)
Assumindo que o utilizador médio faz 3 ações por dia:
| Ação | Endpoint | Créditos | Pedidos/dia | Créditos/dia |
|---|---|---|---|---|
| Visualização de mapa | `/v1/chart` | 20 | 100 | 2 000 |
| Horóscopo diário | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Compatibilidade | `/v1/synastry` | 50 | 30 | 1 500 |
| **Total** | | | **230** | **5 500/dia** |
**~165 000 créditos/mês** (5 500 × 30) → plano **Starter ($19/mês, 200 000 créditos)** com 21% de margem, ou **Indie ($5/mês, 50 000)** com pagamento de *overage* de ~$5 pelos 110K créditos adicionais.
### Cenário: MVP com 20 DAU
| Ação | Créditos/dia |
|---|---|
| 20 mapas | 400 |
| 20 horóscopos | 400 |
| 5 sinastrias | 250 |
| **Total** | **1 050/dia** |
**~31 500 créditos/mês** → plano **Indie ($5/mês, 50 000 créditos)**.
## Dicas
- **Faz cache dos mapas natals** — a entrada é imutável (a data de nascimento não muda), por isso podes guardar o resultado para sempre na tua base de dados
- **Faz cache dos horóscopos por dia** — o horóscopo diário é igual para todas as pessoas do mesmo signo, gera uma vez e distribui
- **Chaves de sandbox** (`aw_test_*`) — para desenvolvimento, não consomem créditos
- **Codegen com OpenAPI 3.1** — usa `/v1/openapi.json` no `openapi-typescript` ou `openapi-python-client` e obtém um cliente tipado (SDK prontos na roadmap)