Notas de engenharia.
Sobre a precisão das efemérides, arquitetura de computação, protocolo MCP e todos os detalhes que não cabem nos docs.
Documentação feita para agentes de IA, não apenas para humanos
A documentação clássica é feita para olhos humanos: HTML bonito, destaque de código, navegação. Mas metade do tráfego para docs agora são agentes e assistentes que precisam de texto simples, não renderizado. Vamos analisar o que adicionamos: um duplo .md para cada página, llms.txt, especificações legíveis por máquina, dropdown 'abrir no ChatGPT / Claude' e try-it inline.
Ler →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.
Ler →Saída MCP tipada: por que 600+ ferramentas têm outputSchema
A maioria dos servidores MCP devolve JSON não tipado aos agentes - o modelo tem de adivinhar o formato da resposta. Publicamos um outputSchema rigoroso para 600+ ferramentas. Analisamos como isto funciona, que bug revelou nos clientes em modo rigoroso e como o corrigimos através de esquemas abertos.
Ler →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.
Ler →Como mantemos a precisão sob controlo: CI contra swetest e NASA
A precisão de uma API de astrologia degrada-se facilmente com uma única refatoração das efemérides. Explicamos a proteção: um único núcleo Swiss Ephemeris para a aplicação e para a API, centenas de snapshots congelados em mapas de referência e a triangulação de cada PR contra swetest CGI, Kerykeion, Prokerala e o catálogo de eclipses da NASA.
Ler →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.
Ler →Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
Ler →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.
Ler →