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.
Un unico pattern per tutte le chiamate
Sezione intitolata “Un unico pattern per tutte le chiamate”Indipendentemente dal dominio, ogni endpoint di calcolo ha la stessa forma:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonIl 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.
Domini del catalogo
Sezione intitolata “Domini del catalogo”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):
| Dominio | Endpoint | Cosa c’è dentro |
|---|---|---|
| Astrologia Occidentale | 186 | Carta natale, aspetti, dignità, prognostica (transiti, progressioni, direzioni), oraria, 4 scuole ellenistiche, moderna psicologica, evolutiva, cosmobiologia |
| Vedica | 230 | Il dominio più grande: nakshatras, dashas, carte divisionali (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodygraph, canali, porte, tipo/profilo/autorità, croce di incarnazione |
| Tarocchi | 71 | Tre mazzi: Rider-Waite-Smith, Marsiglia, Lenormand - stese, significati, combinazioni |
| Numerologia | 55 | 5 sistemi con 10 calcoli (pitagorica, caldea, due cabalistiche, vedica) |
| Cinese + Maya | 55 | BaZi (quattro pilastri), Zi Wei Dou Shu, zodiaco cinese e feng shui, calendari Maya |
| Divinazione | 40 | Geomanzia (Agrippa), rune del Futhark Antico, chiromanzia (Cheiro), I Ching |
| Nicchie Applicate | 53 | Wellness, astrologia animale, business, finanza, familiare |
| Report | 29 | Interpretazioni pronte (natale, sinastria), in HTML/PDF, con branding white-label |
| Render | 14 | Ruote di carte SVG/PNG, bodygraph, anelli di transito - senza il tuo frontend |
| Strumenti Dev | 47 | Webhook, 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).
Vedica - una storia a parte
Sezione intitolata “Vedica - una storia a parte”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.
Precisione alla base di tutto questo
Sezione intitolata “Precisione alla base di tutto questo”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.
Come trovare ciò che ti serve
Sezione intitolata “Come trovare ciò che ti serve”Tre modi, dal più veloce:
- 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”. - 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. - Ricerca per specifica -
curl https://api.astroway.info/v1/openapi.jsonrestituisce il contratto completo leggibile dalla macchina. Comodo per la generazione di codice del tuo client.
Per iniziare
Sezione intitolata “Per iniziare”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.
Posizioni al secondo d'arco in 4 righe di codice.
Chiave API gratuita senza carta. 5 000 chiamate al mese fino al primo pagamento.