Note tecniche.
Sulla precisione delle efemere, l'architettura dei calcoli, il protocollo MCP e tutte le piccole cose che non entrano nella documentazione.
Documentazione creata per agenti AI, non solo per umani
La documentazione classica è creata per gli occhi umani: HTML bello, evidenziazione del codice, navigazione. Ma metà del traffico verso i docs ora è da agenti e assistenti che hanno bisogno di plain-text, non di rendering. Analizziamo cosa abbiamo aggiunto: un duplicato .md per ogni pagina, llms.txt, specifiche leggibili dalla macchina, un menu a tendina 'apri in ChatGPT / Claude' e try-it inline.
Leggi →Numerologia nell'API: 5 sistemi di calcolo con un unico endpoint
La maggior parte delle API o non offre numerologia, o fornisce un solo sistema pitagorico. Noi forniamo 5 sistemi completi (pitagorico, caldeo, due cabalistici, vedico) con 10 calcoli ciascuno, tramite un unico endpoint parametrizzato. Inoltre Matrice del Destino per 22 arcani.
Leggi →Output tipizzato MCP: perché 600+ strumenti hanno outputSchema
La maggior parte dei server MCP restituiscono JSON non tipizzato all'agente - il modello deve indovinare la forma della risposta. Pubblichiamo uno strict outputSchema per 600+ strumenti. Analizziamo come funziona, quale bug ha aperto nei client in strict-mode e come abbiamo risolto tramite schemi aperti.
Leggi →Mappa del catalogo: come sono organizzati gli oltre 700 endpoint di AstroWay
L'API è cresciuta fino a oltre 700 endpoint in 57 gruppi, dal tema natale al BaZi, alla geomanzia e al rendering SVG dei temi. Vediamo come il catalogo è diviso in domini, quale unico pattern seguono tutte le chiamate e come trovare in fretta l'endpoint che ti serve.
Leggi →Come teniamo sotto controllo la precisione: CI contro swetest e NASA
In un'API astrologica la precisione si degrada facilmente con un solo refactoring delle effemeridi. Vediamo le difese: un unico motore Swiss Ephemeris per l'app e l'API, centinaia di snapshot congelati su temi di riferimento e la triangolazione di ogni PR con swetest CGI, Kerykeion, Prokerala e il catalogo delle eclissi della NASA.
Leggi →Tre SDK ufficiali: TypeScript, Python e PHP al posto del curl grezzo
L'HTTP grezzo funziona, ma un client tipizzato fa risparmiare ore: autocompletamento dei percorsi, tipi di richiesta e risposta, retry integrato su 408/409/429/5xx e una gerarchia di errori in stile Stainless. Analizziamo i tre SDK ufficiali, @astroway/sdk (npm), astroway (PyPI) e astroway/sdk (Packagist), e vediamo perché sono generati da un unico contratto OpenAPI.
Leggi →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.
Leggi →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.
Leggi →