Il catalogo di AstroWay conta ormai 865 endpoint in 57 gruppi. A questa scala la domanda principale di un integratore non è “la copertura basterà?”, ma “come faccio a non perdermi?”. Questo articolo è una mappa: come il catalogo è diviso in domini e come trovare quello che ti serve in un minuto.
Un solo pattern per tutte le chiamate
Sezione intitolata “Un solo pattern per tutte le chiamate”Qualunque sia il dominio, ogni endpoint di calcolo ha la stessa forma:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonIl body è un JSON con i dati di nascita (data, ora, coordinate) o con parametri specifici della tecnica. La risposta è sempre { "ok": true, "data": {...} } oppure { "ok": false, "error": {...} }. Niente GraphQL, niente flussi di autenticazione separati per dominio: una chiave nell’header X-Api-Key, un solo formato di risposta.
Questo significa che il wrapper che scrivi per il tema natale va bene anche per il BaZi e per le rune: cambiano solo il percorso e lo schema del body.
I domini del catalogo
Sezione intitolata “I domini del catalogo”Il catalogo è raggruppato in grandi domini. Ecco la mappa con i conteggi reali (i numeri vengono presi dal manifest a ogni build, quindi qui sono sempre aggiornati):
| Dominio | Endpoint | Cosa contiene |
|---|---|---|
| Astrologia occidentale | 186 | Tema natale, aspetti, dignità, tecniche previsionali (transiti, progressioni, direzioni), horary, 4 scuole ellenistiche, astrologia psicologica moderna, 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, Marseille, Lenormand: stese, significati, combinazioni |
| Numerologia | 55 | 5 sistemi con 10 calcoli ciascuno (pitagorico, caldeo, due cabalistici, vedico) |
| Cinese + Maya | 55 | BaZi (quattro pilastri), Zi Wei Dou Shu, zodiaco cinese e feng shui, calendari maya |
| Divinazione | 40 | Geomanzia (Agrippa), rune dell’Elder Futhark, chiromanzia (Cheiro), I Ching |
| Nicchie applicate | 53 | Wellness, astrologia degli animali, business, finanza, famiglia |
| Report | 29 | Interpretazioni pronte (natal, synastry) in HTML/PDF, con branding white-label |
| Rendering | 14 | Ruote dei temi in SVG/PNG, bodygraph, anelli dei transiti, senza un frontend tuo |
| Strumenti per sviluppatori | 47 | Webhook, streaming in tempo reale, widget incorporabili, white-label |
Il resto sono interpretazioni AI, oroscopi, endpoint di riferimento (segni, pianeti, aspetti) ed endpoint di sistema (health, usage, openapi).
La vedica è una storia a parte
Sezione intitolata “La vedica è una storia a parte”230 endpoint vedici sono più dell’intera parte occidentale. Il motivo è semplice: la tradizione vedica è più formalizzata. Dove l’astrologia occidentale ha un solo insieme di case, quella vedica ha 16 carte divisionali (varga), diversi sistemi di dasha, decine di yogas con regole precise. Ognuno di questi è un endpoint a sé con un risultato deterministico.
Se sviluppi per il mercato indiano, questo è il cuore del prodotto, non un’aggiunta.
La precisione sotto a tutto questo
Sezione intitolata “La precisione sotto a tutto questo”Per quanto esotica sia la tecnica, le posizioni planetarie sono calcolate da un unico motore basato su Swiss Ephemeris. Lo stesso motore gira sia nella nostra app sia nell’API: una sola codebase, nessuna divergenza. Gli endpoint di calcolo sono coperti da 888 snapshot test, confrontati con fonti di riferimento a ogni PR. Maggiori dettagli nell’articolo dedicato alla precisione in CI.
Come trovare quello che ti serve
Sezione intitolata “Come trovare quello che ti serve”Tre strade, dalla più veloce:
- Reference OpenAPI: /docs/api/ viene generato direttamente dalla specifica di produzione
openapi.json. I gruppi nella sidebar corrispondono ai domini qui sopra. Ogni endpoint ha lo schema del body, un esempio e un pulsante “prova”. - Catalogo MCP: se lavori in Claude o Cursor, l’intero catalogo è disponibile come set di strumenti tramite
mcp.astroway.info. L’agente trova da solo l’endpoint giusto partendo dalla descrizione. - Ricerca nella specifica:
curl https://api.astroway.info/v1/openapi.jsonrestituisce il contratto completo leggibile da una macchina. Comodo per generare il codice di un client tuo.
Per iniziare
Sezione intitolata “Per iniziare”La chiave su dashboard/sign-up ti dà 10 000 crediti al mese: abbastanza per esplorare decine di domini e capire quali fanno per te. Non serve studiare tutto il catalogo: prendi il tuo dominio, il resto aspetterà finché non ti servirà.
Posizioni al secondo d'arco in 4 righe di codice.
Chiave API gratuita senza carta. 5 000 chiamate al mese fino al primo pagamento.