How we build the API.
Internals, postmortems, and design decisions. Everything we wish someone had written down before we had to figure it out the hard way.
Numerologia no API: 5 sistemas de cálculo via um único endpoint
A maioria das APIs não tem numerologia ou oferece apenas um sistema pitagórico. Nós temos 5 sistemas completos (pitagórico, caldeu, dois cabalísticos, védico) com 10 cálculos cada, via um único endpoint parametrizado. Mais a Matriz do Destino com 22 arcanas.
Mapa do catálogo: como estão organizados os 700+ endpoints AstroWay
O API cresceu para mais de 700 endpoints em 57 grupos - desde o mapa natal até BaZi, geomancia e renderização de mapas SVG. Explicamos como o catálogo está dividido em domínios, com um padrão único para todas as chamadas e como encontrar rapidamente o endpoint necessário.
Três SDKs oficiais: TypeScript, Python e PHP em vez de curl puro
HTTP puro funciona, mas um cliente tipado poupa horas: autocompletar de caminhos, tipos de pedido e de resposta, retry integrado em 408/409/429/5xx e uma hierarquia de erros ao estilo Stainless. Analisamos os três SDKs oficiais, @astroway/sdk (npm), astroway (PyPI) e astroway/sdk (Packagist), e como são gerados a partir de um único contrato OpenAPI.
Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
Natal Chart API in PHP: SDK + Laravel Example
Compute a natal chart in PHP with the AstroWay SDK - plain PHP and a Laravel facade - without compiling a Swiss Ephemeris extension.
Natal Chart API in Python: 3 Examples with the AstroWay SDK
How to compute a natal chart in Python via API - install, first request, transits and synastry - with working code and how it compares to pyswisseph and kerykeion.
Natal Chart API in TypeScript: SDK + React Example
Compute a natal chart in TypeScript with the AstroWay SDK - typed responses, a React component, and where it beats a local ephemeris library.
X-Cache header: cache-status visível para otimização de integrações do cliente
Cada resposta da API agora carrega X-Cache: MISS | HIT | BYPASS - o cliente vê imediatamente se o pedido foi calculado do zero ou recuperado da cache. Isto abre uma coluna de % de cache hit em /dashboard/usage e permite otimizar a integração sem adivinhações.
Reports V2: um endpoint em vez de doze - `/v1/reports/generate`
Em vez de 12 rotas type-specific /reports/natal, /reports/synastry, … - um endpoint unificado POST /v1/reports/generate com o campo report_type. Os consumidores do SDK obtêm um método em vez de doze; o catálogo MCP reduz‑se de 12 instrumentos para um.
Astrologia védica por API: de Parashara ao Lal Kitab em 354 endpoints
A AstroWay oferece agora a cobertura védica mais completa entre as APIs comerciais: 10 sistemas de dashas, 16 vargas, Panchang, Lal Kitab completo + KP + Jaimini. Como funciona e quando escolher cada técnica.
White-label PDF sem WordPress: branding inline através de um único campo
O campo whitelabel nos esquemas de todos os 12 endpoints /v1/reports/* agora aceita não apenas boolean (ler configuração da BD), mas também um objeto inline com 15 campos. Isto remove a dependência do utilizador WordPress - qualquer consumidor SaaS da API pode personalizar PDFs em tempo real, sem uma página de admin separada.
Como construir um aplicativo de astrologia: guia completo para desenvolvedores
Guia passo a passo para criar um aplicativo de astrologia do zero - escolha da API, arquitetura, primeira carta natal, adição de sinastria e trânsitos, deploy.
Início Rápido da API de Astrologia: TypeScript e Python em 5 minutos
Instalar o SDK, obter a chave da API, fazer a primeira solicitação da carta natal. 5 minutos - e um JSON funcional em mãos (TypeScript e Python).
API de Retificação: correção do horário de nascimento para desenvolvedores
A retificação é o processo de refinar o horário de nascimento desconhecido ou impreciso com base em eventos da vida. Neste post, como automatizar isso por meio da API usando o método algorítmico e a Trutine de Hermes.
O mesmo Swiss Ephemeris que no Solar Fire - em 4 linhas de código.
Chave gratuita sem cartão. 5 000 chamadas por mês até o primeiro pagamento.