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 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.
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.
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.
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: stato cache visibile per l'ottimizzazione delle integrazioni client
Ogni response API ora include X-Cache: MISS | HIT | BYPASS - il cliente vede immediatamente se la richiesta è stata calcolata da zero o prelevata dalla cache. Questo apre la colonna cache hit % in /dashboard/usage e permette di ottimizzare l'integrazione senza guesswork.
Reports V2: un endpoint invece di dodici - `/v1/reports/generate`
Invece di 12 route type-specific /reports/natal, /reports/synastry, … - un endpoint unificato POST /v1/reports/generate con il campo report_type. I consumatori SDK ottengono un metodo invece di dodici; il catalogo MCP si riduce da 12 strumenti a uno.
Astrologia vedica via API: da Parashara al Lal Kitab in 354 endpoint
AstroWay offre ora la copertura vedica più completa tra le API commerciali: 10 sistemi di dasha, 16 varga, Panchang, Lal Kitab completo + KP + Jaimini. Come funziona e quale tecnica scegliere in ogni caso.
White-label PDF senza WordPress: branding inline tramite un unico campo
Il campo whitelabel negli schemi di tutti gli 12 endpoint /v1/reports/* ora accetta non solo boolean (per leggere la configurazione del DB), ma anche un oggetto inline con 15 campi. Questo rimuove la dipendenza dall'utente WordPress - qualsiasi consumatore API SaaS può brandare PDF al volo, senza una pagina admin separata.
Come costruire un'applicazione astrologica: guida completa per gli sviluppatori
Guida passo dopo passo per la creazione di un'applicazione astrologica da zero - scelta dell'API, architettura, prima carta natale, aggiunta di sinastria e transiti, deploy.
Avvio rapido API astrologia: TypeScript e Python in 5 minuti
Installare SDK, ottenere chiave API, effettuare prima richiesta di carta natale. 5 minuti - e un JSON funzionante in mano (TypeScript e Python).
Rectification API: correzione dell'orario di nascita per gli sviluppatori
La rettificazione è il processo di correzione dell'orario di nascita sconosciuto o impreciso in base agli eventi della vita. In questo post - come automatizzarla tramite API utilizzando il metodo algoritmico e la Trutina di Hermes.
Lo stesso Swiss Ephemeris di Solar Fire - in 4 righe di codice.
Chiave API gratuita senza carta. 5 000 chiamate al mese fino al primo pagamento.