Il catalogo AstroWay è già 758 endpoint in 57 gruppi. A questo livello di scala, il principale problema dell’integratore non è “se c’è copertura”, ma “come non perdersi”. Questo articolo è una mappa: come il catalogo è diviso in domini e come trovare quello che serve in un minuto.
Un pattern per tutti gli endpoint
Sezione intitolata “Un pattern per tutti gli endpoint”Indipendentemente dal dominio, ogni endpoint calcolato 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": {...} }. Nessun GraphQL, nessun flusso di autenticazione separato per dominio: un solo chiave nel header X-Api-Key, un solo formato di risposta.
Questo significa che l’interfaccia che scrivi sotto la mappa è adatta sia per BaZi che per run - cambia solo il percorso e la schema del corpo.
I domini del catalogo
Sezione intitolata “I domini del catalogo”Il catalogo è suddiviso in grandi domini. Ecco la mappa con i numeri reali (i numeri sono presi dal manifesto per ogni build, quindi sono sempre aggiornati):
| Dominio | Endpoint | Cosa ci trovi dentro |
|---|---|---|
| Astrologia occidentale | 182 | Mappa natale, aspetti, dignità, progetti (trasiti, progressioni, direzioni), orari, 4 scuole ellenistiche, psicologia moderna, evoluzione, biologia cosmica |
| Vedica | 174 | Il più grande dominio: nakshatras, dashas, divisional- carte (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Design umano | 12 | Bodigrafo, canali, porte, tipo/profilo/autorità, incarico |
| Tarocchi | 66 | Tre tarocchi: Rider-Waite-Smith, Marseille, Lenormand - schemi, significato, combinazioni |
| Numerologia | 50 | 5 sistemi per 10 calcoli (pitagorico, caldeo, due cabalistici, vedico) |
| Cinese + Maya | 55 | BaZi (quattro colonne), Zi Wei Dou Shu, zodiaco cinese e fen-shui, calendario Maya |
| Divinazione | 31 | Geomancia (Agrippa), runi del vecchio Futhark, chiromanzia (Cheiro), I Ching |
| Niche applicative | 51 | Benessere, astrologia animali, business, finanza, famiglia |
| Report | 23 | Interpretazioni pronte (natale, sinestra), in HTML/PDF, con white-label branding |
| Rendering | 14 | Ruote di carta, grafici, cerchi di transito - senza front-end |
| Strumenti di sviluppo | 44 | Webhook, streaming in tempo reale, widget integrati, white-label |
Il resto è interpretazione AI, oroscopi, endpoint informativi (segno, pianeta, aspetti) e sistemi (salute, utilizzo, OpenAPI).
La Vedica - una storia separata
Sezione intitolata “La Vedica - una storia separata”174 endpoint vedici sono più di quelli occidentali. La ragione è semplice: la tradizione vedica è più formale. Lì dove l’astrologia occidentale ha un solo insieme di case, la Vedica ha 16 divisional- carte (varga), diverse sistemi dasha, decine di yogas con regole chiare. Ogni uno di questi è un endpoint con risultato determinato.
Se stai costruendo per il mercato indiano, questo è il nucleo del prodotto, non un add-on.
Precisione sotto tutto questo
Sezione intitolata “Precisione sotto tutto questo”Indipendentemente dall’esotismo della tecnica, le posizioni planetarie sono calcolate con un solo nucleo su Swiss Ephemeris (WASM). Lo stesso nucleo funziona sia nel browser del nostro applicativo che sul server API - una sola base di codice, nessuna differenza. Gli endpoint calcolati sono coperti da 873 snapshot-test, che vengono verificati con fonti di riferimento di rilascio. Dettagli su questo sono nella sezione separata sulla precisione del CI.
Trova quello che serve
Sezione intitolata “Trova quello che serve”Tre strade, dalla più veloce:
- OpenAPI- catalogo - /docs/api/ è generato direttamente dalla specifica di prodotto
openapi.json. Le griglie nella barra laterale sono i domini sopra. Ogni endpoint ha una schema del corpo, un esempio e un pulsante “Prova”. - MCP- catalogo - se sei in Claude o Cursor, tutto il catalogo è disponibile come insieme di strumenti attraverso
mcp.astroway.info. L’agente trova automaticamente l’endpoint giusto per la descrizione. - Cerca nella specifica -
curl https://api.astroway.info/v1/openapi.jsonrestituisce il contratto completo. È comodo per la generazione di codice del tuo cliente.
La chiave su dashboard/sign-up dà 10.000 crediti al mese - abbastanza per esplorare decine di domini e capire cosa è questo. Il catalogo non deve essere studiato completamente: prendi il tuo dominio, e il resto aspetterà quando sarà necessario.
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.