Pular para o conteúdo
AstroWay/api v2.102.11 · pt
todos os sistemas normais

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: 723 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.

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

Seção intitulada “Endpoints principais para aplicações astrológicas”
EndpointCréditosPara que serve
/v1/chart20Construção de mapa natal
/v1/synastry50Compatibilidade entre duas pessoas
/v1/horoscope/daily20Horóscopo diário

Três endpoints e já tens um produto funcional com mapa natal, compatibilidade e conteúdo diário.

EndpointCréditosPara que serve
/v1/transits50Trânsitos atuais no mapa natal
/v1/solar-return50Mapa solar (anual)
/v1/progressions50Progressões secundárias
/v1/interpret/natal50Interpretação com IA do mapa natal
/v1/transit-calendar100Calendário de eventos de trânsitos
/v1/human-design50Mapa de Human Design
EndpointCréditosPara que serve
/v1/rectification500Correção de hora de nascimento
/v1/acg50Astrocartografia (onde viver melhor)
/v1/forecast-calendar100Previsão anual em formato heatmap
/v1/group-synastry100Compatibilidade em grupo

Assumindo que o utilizador médio faz 3 ações por dia:

AçãoEndpointCréditosPedidos/diaCréditos/dia
Visualização de mapa/v1/chart201002 000
Horóscopo diário/v1/horoscope/daily201002 000
Compatibilidade/v1/synastry50301 500
Total2305 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.

AçãoCréditos/dia
20 mapas400
20 horóscopos400
5 sinastrias250
Total1 050/dia

~31 500 créditos/mês → plano Indie ($5/mês, 50 000 créditos).

  • 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)
Útil?
Запропонувати правку

Última atualização: