AstroWay/api v2.356.2 · it
tutti i sistemi sono operativi

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.

Il catalogo AstroWay conta già 865 endpoint in 57 gruppi. A questa scala, la domanda principale per un integratore non è “la copertura sarà sufficiente?”, ma “come non perdersi?”. Questo articolo è una mappa: come il catalogo è diviso in domini e come trovare ciò che ti serve in un minuto.

Indipendentemente dal dominio, ogni endpoint di calcolo ha la stessa forma:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Il corpo è un JSON con i dati di nascita (data, ora, coordinate) o parametri specifici per la tecnica. La risposta è sempre { "ok": true, "data": {...} } o { "ok": false, "error": {...} }. Niente GraphQL, nessun auth-flow separato per dominio: una singola chiave nell’header X-Api-Key, un unico formato di risposta.

Questo significa che il wrapper che scrivi per la carta natale è adatto anche per BaZi e per le rune – cambiano solo il percorso e lo schema del corpo.

Il catalogo è raggruppato in grandi domini. Ecco una mappa con i contatori reali (i numeri sono presi dal manifesto ad ogni build, quindi sono sempre aggiornati qui):

DominioEndpointCosa c’è dentro
Astrologia Occidentale186Carta natale, aspetti, dignità, prognostica (transiti, progressioni, direzioni), oraria, 4 scuole ellenistiche, moderna psicologica, evolutiva, cosmobiologia
Vedica230Il dominio più grande: nakshatras, dashas, carte divisionali (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala
Human Design12Bodygraph, canali, porte, tipo/profilo/autorità, croce di incarnazione
Tarocchi71Tre mazzi: Rider-Waite-Smith, Marsiglia, Lenormand - stese, significati, combinazioni
Numerologia555 sistemi con 10 calcoli (pitagorica, caldea, due cabalistiche, vedica)
Cinese + Maya55BaZi (quattro pilastri), Zi Wei Dou Shu, zodiaco cinese e feng shui, calendari Maya
Divinazione40Geomanzia (Agrippa), rune del Futhark Antico, chiromanzia (Cheiro), I Ching
Nicchie Applicate53Wellness, astrologia animale, business, finanza, familiare
Report29Interpretazioni pronte (natale, sinastria), in HTML/PDF, con branding white-label
Render14Ruote di carte SVG/PNG, bodygraph, anelli di transito - senza il tuo frontend
Strumenti Dev47Webhook, streaming in tempo reale, widget incorporabili, white-label

Il resto include interpretazioni AI, oroscopi, endpoint di riferimento (segni, pianeti, aspetti) e sistemici (health, usage, openapi).

230 endpoint vedici sono più dell’intera sezione occidentale. La ragione è semplice: la tradizione vedica è più formalizzata. Laddove l’astrologia occidentale ha un unico set di case, quella vedica ha 16 carte divisionali (varga), diversi sistemi dasha, decine di yogas con regole chiare. Ognuno di questi è un endpoint separato con un risultato determinato.

Se stai costruendo per il mercato indiano, questo è il cuore del prodotto, non un’aggiunta.

Indipendentemente dall’esoticità della tecnica, le posizioni planetarie sono calcolate da un unico core con una precisione al secondo d’arco, verificata con NASA JPL Horizons. Lo stesso core funziona sia nella nostra applicazione che nell’API – una singola codebase, nessuna discrepanza. Gli endpoint di calcolo sono coperti da 889 snapshot test che, ad ogni PR, vengono confrontati con fonti di riferimento. Maggiori dettagli su questo sono disponibili in un articolo separato sulla precisione CI.

Tre modi, dal più veloce:

  1. Riferimento OpenAPI - /docs/api/ è generato direttamente dalla specifica di produzione openapi.json. I gruppi nella sidebar = i domini sopra. Ogni endpoint ha uno schema del corpo, un esempio e un pulsante “prova”.
  2. Catalogo MCP - se sei in Claude o Cursor, l’intero catalogo è disponibile come set di strumenti tramite mcp.astroway.info. L’agente trova autonomamente l’endpoint necessario in base alla descrizione.
  3. Ricerca per specifica - curl https://api.astroway.info/v1/openapi.json restituisce il contratto completo leggibile dalla macchina. Comodo per la generazione di codice del tuo client.

Una chiave su dashboard/sign-up ti dà 10.000 crediti al mese – sufficienti per esplorare decine di domini e capire cosa fa per te. Non è necessario studiare l’intero catalogo: prendi il tuo dominio, e il resto aspetterà quando ne avrai bisogno.

MakSeong · AstroWay

Sto sviluppando l'API AstroWay: sto avvolgendo la matematica astrologica al secondo d'arco in un REST pulito e scrivo sui dettagli noiosi che sono in realtà importanti.

// costruisci su questo

Posizioni al secondo d'arco in 4 righe di codice.

Chiave API gratuita senza carta. 5 000 chiamate al mese fino al primo pagamento.

Altro dal blog tutti gli articoli →

Engineering 2026-07-15

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.

Industry 2026-06-05

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.

Engineering 2026-06-05

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.