Changelog what is new

Tutte le modifiche che influenzano il codice dell’integratore: nuovi endpoint, aggiornamenti SDK, cambiamenti in /openapi.json, correzioni dei prezzi in crediti, deprecation, breaking changes. Le più recenti sono in cima. Le modifiche interne al sito non vengono registrate qui.

Il contratto API è stabile all’interno di /v1/* — qualsiasi breaking change viene rilasciata sotto /v2/*, mentre /v1/* continua a funzionare per almeno 12 mesi.

2026-05-16 — Endpoint MCP hosted live su mcp.astroway.info/mcp

@astroway/mcp è ora disponibile in due modalità di trasporto. Lo stdio (pacchetto npm) rimane invariato; è stato aggiunto un hosted Streamable HTTP endpoint per l’integrazione zero-install in Claude $1 (claude.ai nel browser), Claude $1, Cursor, Cline e altri client MCP compatibili.

Installazione in un clic per Cursor — il pulsante cursor://anysphere.cursor-deeplink/mcp/install?... è disponibile nella pagina /examples/mcp/. Per Claude $1, tramite + → Add Connector → Custom (senza modificare il JSON).

// Opzione JSON per Cline / Continue / Windsurf
{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Lo stesso catalogo di 630 strumenti + 12 prompt + 14 risorse, stessa autorizzazione aw_test_* / aw_live_* (nella modalità hosted tramite Authorization: Bearer … header invece che la variabile d’ambiente), stesso credit pool. Multi-tenant by design — ogni richiesta include la propria chiave e i crediti vengono addebitati sul conto del proprietario della chiave. Il canale in X-Astroway-Channel è mcp-http (hosted) vs mcp (stdio) per il tracciamento dell’adozione.

Perché due modalità. Lo stdio (npx @astroway/mcp) rimane per gli utenti avanzati di Cursor e gli integratori attenti alla privacy — la chiave non lascia mai la macchina, senza hop di rete. L’hosted copre il segmento di Claude $1 (che supporta solo MCP remoto) e gli scenari zero-install. Lo stesso pattern di Stripe / Resend / GitHub MCP.

Endpoint di health — raggiungibile pubblicamente senza autorizzazione:

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"2024-11-05"}

La documentazione completa di entrambe le modalità è disponibile su /examples/mcp/.

2026-05-15 — Nuovo endpoint GET /v1/auth/keys/me

Introspezione della chiave API. Invia X-Api-Key — ottieni lo stato completo: piano, crediti, stato, dominio associato, data di creazione, fonte di registrazione. Utile per i consumatori SDK (TS / Python / PHP / MCP) — “cosa ho attualmente come chiave” senza dover leggere la dashboard. Analogo a Stripe /v1/account o GitHub /user.

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # primi 11 caratteri, la chiave completa non viene mai restituita
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # fine del mese solare
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # dominio a cui la chiave è associata (chiavi wp-plugin)
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

Senza auth: 401 MISSING_API_KEY. Chiave non valida: 401 INVALID_API_KEY.

Specifica OpenAPI 3.1. /v1/openapi.json ora dichiara /v1/auth/keys/me. La prossima rigenerazione del codice SDK includerà client.auth.keys.me().

Retrocompatibilità. Il vecchio GET /v1/keys/usage (restituiva solo credits_today + rate limit) continua a funzionare — è un endpoint separato per le verifiche cron dei server. /auth/keys/me restituisce lo stato completo più l’associazione al dominio per gli scenari wp-plugin.

2026-05-14 — Localizzazione di /horoscope/* e /interpret/* (21 lingue)

I 10 endpoint POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility} e POST /v1/interpret/{natal,synastry,transits,element,placement} — che restituiscono testo interpretativo — ora restituiscono la risposta nella lingua del client.

Come attivare:

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Accept-Language: hi" \
  -H "Content-Type: application/json" \
  -d '{"sign": "leo"}'
# → risposta in hindi

Priorità di risoluzione (server-side):

1. body.language="de" — parametro esplicito per chiamata (priorità più alta)
2. Accept-Language: de, en;q=0.7 — RFC 7231 q-weighted; il primo codice che corrisponde alla lingua attiva vince
3. ?lang=de — parametro query per client che non controllano gli header
4. Fallback → uk (lingua sorgente)

Lingue supportate (21): uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id. Codici sconosciuti vengono silenziosamente ricaduti su uk senza errori.

Specifica OpenAPI 3.1. /v1/openapi.json ora dichiara Accept-Language (header) e lang (query) come parametri con enum di 21 codici su questi 10 endpoint. La prossima rigenerazione SDK (openapi-typescript, openapi-generator-cli) includerà automaticamente chiamate tipizzate .lang('hi').

Cosa viene tradotto: solo i campi testuali dell’interpretazione (horoscope, interpretation, disclaimer, ecc.). I campi numerici (longitude, latitude, score, ID dei segni, ID delle case) rimangono canonici — il client li formatta localmente. Standard del segmento (Vedika, DivineAPI, AstrologyAPI.com).

Ambito: attualmente vengono localizzati 10 endpoint del gruppo interpretativo. Gli endpoint di calcolo (/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690 altri) restituiscono numeri e identificatori canonici (name: "Aries", glyph: "♈") invariati — il client li localizza tramite le proprie tabelle di lookup. Questo è lo standard del segmento.

Retrocompatibile. Il codice esistente senza Accept-Language / ?lang= / body.language riceve uk come predefinito, come prima.

Il supporto SDK (@astroway/sdk, astroway, astroway/sdk, @astroway/mcp) aggiunge l’opzione lang nel costruttore — i singoli rilasci arriveranno nelle prossime settimane tramite l’applicazione cron sui repository di staging.

2026-05-09 — Tre SDK lanciati: TypeScript, Python, PHP

Tre SDK ufficiali sono disponibili nei registri pubblici — wrapper intorno agli stessi 700+ endpoint API. Una specifica OpenAPI 3.1 → tre client idiomatici per linguaggio.

Cosa significa per l’integratore:

• Alternativa tipizzata all’HTTP grezzo. Autocompletamento dei path + tipi di richieste e risposte nell’IDE. Helper methods aw.post('/chart', body=...) (Python/PHP) o aw.client.POST('/chart', { body }) (TS) — invece di fetch / requests / Guzzle manuali.
• Interfaccia identica tra linguaggi. Il costruttore Astroway({apiKey, baseUrl, authScheme, timeout, retry}) funziona allo stesso modo in TS / Python / PHP. Se il progetto è multilingua — meno overhead cognitivo.
• Ritry integrato su 408/409/429/5xx con exponential backoff + jitter completo. Rispetta l’header Retry-After. 2 tentativi predefiniti, configurabili tramite retry={maxRetries: 0}.
• Gerarchia di errori basata sul template Stainless — lo stesso pattern degli SDK di Stripe / OpenAI / Cloudflare. Cattura RateLimitError (con retryAfterSeconds), AuthenticationError (ruota la chiave), BadRequestError (validazione), ApiError (generico) — in quest’ordine.
• Due schemi di autenticazione. Predefinito X-Api-Key: aw_live_... (come in curl/Postman). Oppure Authorization: Bearer aw_live_... (come negli SDK di Stripe/OpenAI/Anthropic) — auth_scheme="bearer" nel costruttore.
• Header di identificazione, nessuna telemetria. Ogni richiesta include User-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>. Nessun phone-home, nessun interruttore opt-in/opt-out.
• OIDC + SLSA L3 provenance (TS + Python). Record attestato da Sigstore che il pacchetto è stato costruito da un commit specifico nel repo pubblico. Nessun token a lunga durata nella CI.
• MIT, codice sorgente completamente aperto su github.com/astroway/{astroway-typescript,astroway-python,astroway-php}.

Quick start:

// TypeScript / Node 20+
import { Astroway } from '@astroway/sdk';
const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const { data } = await aw.client.POST('/chart', { body: { date: '1990-07-14', /* ... */ } });

# Python 3.9+
from astroway import Astroway
aw = Astroway(api_key=os.environ['ASTROWAY_API_KEY'])
chart = aw.post('/chart', body={'date': '1990-07-14', ...})

// PHP 8.1+
use Astroway\Astroway;
$aw = new Astroway(['apiKey' => getenv('ASTROWAY_API_KEY')]);
$chart = $aw->post('/chart', body: ['date' => '1990-07-14', /* ... */]);

Opzione async per Python — AsyncAstroway con interfaccia identica tramite async/await. In PHP — solo sync (PHP non ha una storia unificata di async). In TS — promesse native basate su openapi-fetch.

Questa è una versione alpha — l’API pubblica potrebbe spostarsi verso 0.1.0 proper in base al feedback degli integratori. Durante la fase alpha, pinna la versione esatta (@astroway/sdk@0.1.0-alpha.1) o installa l’ultima alpha disponibile al momento.

@astroway/mcp — il server MCP per Claude / Cursor / GPT — continua a vivere accanto come prodotto separato.

2026-05-07 — Refresh del server MCP

@astroway/mcp è stato aggiornato — genera automaticamente il catalogo degli strumenti dallo stato corrente di /openapi.json senza modifiche manuali. Tutto ciò che è apparso nell’API nelle ultime settimane (suite di compatibilità, endpoint di report) è immediatamente visibile a Claude / Cursor / GPT.

Per l’integratore:

• Il catalogo degli strumenti riflette lo stato attuale dell’API
• Gli endpoint con template di path (/v1/.../id) vengono saltati per ora per non confondere il parser di descrizione
• Annotazioni di costo nella descrizione degli strumenti — Claude vede il costo della chiamata prima dell’esecuzione
• OIDC trusted publishing + SLSA L3 provenance — il pacchetto è attestato a un commit specifico nel repo pubblico astroway/astroway-mcp

Installazione:

npm install -g @astroway/mcp

Oppure tramite la configurazione MCP di Claude $1 / Cursor:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"]
    }
  }
}

Fonte: repo pubblico astroway/astroway-mcp (MIT).

2026-04-11 — Compatibilità cross-system (+10 endpoint)

Nuovo gruppo /v1/compat/* — punteggio di compatibilità unificato tra astrologia occidentale, vedica, cinese, numerologia, tarot, human design. 6 sistemi forniscono una metrica unificata per gli indicatori UX nelle applicazioni astrologiche multi-tradizione.

Ogni endpoint restituisce JSON con un campo disclaimer — questa è la metodologia di scoring di AstroWay, non un’affermazione clinica o legale. Tier 4 (100 crediti) per chiamata — calcolo cross-system pesante.

Il manifest su /openapi.json è stato aggiornato — SDK / MCP lo raccoglieranno automaticamente.

2026-03-28 — Report + Webhook (+17 endpoint)

Due nuovi gruppi in produzione.

/v1/reports/* (12 endpoint) — generazione di report HTML / PDF tramite Puppeteer. Render lato server API-calc, URL di download firmato (TTL 24h).

/v1/webhooks/* (5 endpoint) — gestione delle sottoscrizioni, consegna degli eventi, firma HMAC. Sottoscrizione agli eventi credits.low, key.created, usage.threshold, error.spike.

curl -X POST https://api.astroway.info/v1/webhooks \
  -H "Authorization: Bearer aw_live_..." \
  -d '{"url": "https://...", "events": ["credits.low"], "secret": "wh_secret_..."}'

Ogni consegna include X-Astroway-Signature: sha256=<hmac> — verifica tramite secret. Politica di retry: exponential backoff su 5xx, fino a 5 tentativi in 24 ore.

2026-03-14 — Endpoint di riferimento: pubblici, senza chiave, senza crediti

14 endpoint /v1/reference/* (segni, pianeti, case, aspetti, elementi, modalità, polarità, dignità, decani, nakshatra, lotti, asteroidi, sistemi zodiacali, glifi) ora funzionano senza X-Api-Key e costano 0 crediti. Si tratta di tabelle di lookup canoniche — fatturarle attraverso il billing era una svista progettuale.

Cosa significa per l’integratore:

• Chiamata senza chiave — agenti MCP esterni / SDK / pagine di anteprima possono recuperare i dati di riferimento senza autorizzazione. Il rate limit IP rimane come su /public (30 richieste / ora).
• Manifesto dei costi aggiornato — 14 percorsi sono passati da TIER_HALF (5 crediti) a 0. Se il tuo pianificatore di budget astroway_cost_estimate fa riferimento a questi percorsi — le nuove chiamate non toccano la quota.
• Clienti esistenti con chiave funzionano senza modifiche. X-Api-Key viene ignorato per /reference/* (non insistiamo su un header extra).

Retrocompatibile: le risposte 200 e lo schema JSON non cambiano, solo il requisito di autorizzazione viene rimosso.

2026-03-07 — Founders’ Lifetime Deal: $299 → piano Indie a vita

Lanciamo il Founders’ Lifetime Deal — lancio limitato. I primi 100 clienti pagano $299 una tantum e ricevono il piano Indie (50.000 crediti/mese) per sempre, senza addebiti ricorrenti, con prezzo fisso.

Cosa significa per gli integratori:

• Indie standard = $5/mese. Founders’ = $299 una tantum → punto di pareggio al 5° anno, poi ROI illimitato. Se il tuo progetto dura almeno 5 anni nell’astrologia / numerologia / Tarot — il Founders’ si ripaga.
• Payload del webhook al checkout SKU astroway-api-indie-lifetime: la stringa api_keys riceve plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. Nessun addebito mensile, nessun webhook di rinnovo.
• Schema DB: aggiunte le colonne is_lifetime TINYINT(1) in api_keys e shared_user_quotas. Il tipo TS ApiKeyInfo è stato esteso. Le chiavi esistenti = is_lifetime=0 (nessun cambiamento di comportamento).
• Endpoint WP REST GET /wp-json/astroway/v1/founders-count restituisce {sold, total: 100, remaining, available} — usato in site/components/founders/FoundersCounter.astro per il contatore in tempo reale sulla pagina /founders/.
• Disattivazione automatica a 100/100: lo stato _stock_status del prodotto WC passa automaticamente a outofstock tramite l’hook WC woocommerce_order_status_completed. Dopo di che, il link al checkout reindirizza a /pricing/#indie (Indie standard $5/mese).

Pagine live: /founders/ (uk) + /en/founders/ (en). Voce laterale “Founders’ Lifetime Deal” con badge 🚀 100 only.

Prodotto WP: astroway-api-indie-lifetime, ID 30618, $299 (13225 UAH), stock=100. Checkout: astroway.info/checkout/?add-to-cart=30618.

2026-03-05 — Pagina di atterraggio GDPR / residenza UE + badge Pro card EU

Lanciamo /eu/ — una pagina separata per gli sviluppatori UE il cui prodotto è sensibile al GDPR. È importante per l’integratore sapere:

• Pro $59 = residenza UE predefinita (Hetzner Norimberga, flusso di dati solo all’interno dell’UE, analisi anonima — Plausible senza cookie in roadmap).
• DPA standard disponibile non solo per l’Enterprise — firmato tramite email sul piano Pro standard in 5 giorni lavorativi.
• DELETE /v1/me/account — endpoint per il diritto all’oblio GDPR (cancella istantaneamente il tuo wp_user_id da tutte le tabelle).
• La card Pro su /pricing/ ora ha il badge 🇪🇺 GDPR-ready — il clic porta a /eu/ con FAQ completa.
• DivineAPI / AstrologyAPI / Prokerala — hosting US/India, DPA solo su Enterprise. Se la conformità GDPR è critica — Pro $59 è il percorso più economico.

Pagine: /eu/ (uk) + /en/eu/ (en). Voce laterale «GDPR / EU residency» con badge 🇪🇺.

2026-03-03 — Pagamento annuale −25% + trasferimento crediti + funzioni Pro pubbliche

Due modifiche che influenzano il codice degli integratori:

• Sconto annuale 17% → 25% (3 mesi gratis invece di 2). Nuovi prezzi annuali in USD: Indie $45, Starter $171, Pro $531, Business $1791, HD/Esoteric Pack $81, Vedic Pack $171, Reports Pack $891. Gli abbonamenti annuali esistenti non vengono toccati — il nuovo prezzo si applica solo ai futuri rinnovi dell’abbonamento. Se hai parsato i prezzi in USD tramite /wp-json/astroway/v1/api-prices — i nuovi valori vengono ora restituiti automaticamente.
• Trasferimento dei crediti per gli abbonati annuali: i crediti non utilizzati passano al ciclo mensile successivo, limitati a 1× il limite mensile del piano. Attivato automaticamente al momento dell’acquisto del piano annuale. Visibile tramite nuovi header di risposta:
  • X-Credits-Limit: <int> — limite mensile effettivo (include il trasferimento)
  • X-Credits-Remaining: <int> — come prima, ma tenendo conto del trasferimento
  • X-Credits-Rollover: <int> — saldo attuale dei crediti trasferiti (solo per annuali)
• Il piano Pro ($59) ora viene pubblicizzato apertamente: endpoint in streaming (in tempo reale), fatturazione UE compatibile GDPR, MCP esteso (multi-agent / debate / RAG), webhook (10 tipi). Si tratta di funzioni già presenti in Pro — prima nascoste nella documentazione.

Schema DB: aggiunte le colonne credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED in api_keys e shared_user_quotas. Inizialmente — entrambe = 0 per tutte le chiavi esistenti.

2026-03-01 — Tabella trasparente dei costi dei crediti per endpoint

Lanciamo una pagina pubblica /credits/ con una suddivisione completa dei crediti per tutti i 700+ endpoint. Nessun competitor (DivineAPI, AstrologyAPI, Prokerala) pubblica una tabella del genere — loro prendono 1 credito/fixed call e nascondono il routing interno.

Per l’integratore, questo offre tre vantaggi:

• Unità economica trasparente — costo esatto $/call per ogni endpoint (budget mensili /pricing/ × costo del piano = costo reale per call).
• Sincronizzazione automatica con il codice — la tabella viene generata durante il build da endpoint-costs.ts. Se aggiungiamo un nuovo endpoint o cambiamo il piano — la pagina si aggiorna automaticamente al prossimo deploy.
• Marcatore del piano Free — la colonna mostra quali endpoint richiedono Indie+ (icona 🔒, 28 endpoint attualmente).

Disponibile su: /credits/ (uk) e /en/credits/ (en). Collegamenti incrociati da /rate-limits-credits/ e voce laterale Starlight (icona «Nuovo»).

2026-02-27 — Mappe Vedic, cosmogramma, percorso eclissi, mappa stellare (+6 endpoint)

Completamento della categoria Visualizzazione con 14/14 endpoint come da roadmap:

• POST /v1/render/wheel-vedic-north — layout North Indian (diamante). Case fisse, segni ruotano in base alla lagna.
• POST /v1/render/wheel-vedic-south — griglia South Indian (4×4). Segni fissi (Pesci in alto a sinistra), case fluttuanti.
• POST /v1/render/wheel-vedic-east — East Indian (Bengalese). Quadrato con diagonali + quadrato interno ruotato.
• POST /v1/render/cosmogram — Cosmobiologia della Scuola di Amburgo 90°-dial (Ebertin 1940 + Witte 1928).
• POST /v1/render/eclipse-path — mappa mondiale equirettangolare con tracciato lat/lon fornito dal chiamante; rende la linea centrale + fascia di larghezza specificata.
• POST /v1/render/star-map — proiezione stereografica di una lista di punti (RA/Dec) con scalatura della magnitudine.

Tutti i rendering sono SVG puri, senza headless-Chrome.

2026-02-25 — Bi-/tri-wheel + composite + bioritmo (+4 endpoint)

Quattro nuovi endpoint di visualizzazione che estendono la meccanica SVG:

• POST /v1/render/bi-wheel — due cerchi concentrici: interno per la carta natale + anello esterno con pianeti in transito (o progressivi).
• POST /v1/render/tri-wheel — tre cerchi: natale + progressivo + transito.
• POST /v1/render/composite — rendering della carta composita da due input natali (composito midpoint).
• POST /v1/render/biorhythm — grafico sinusoidale di tre cicli: fisico (23 giorni), emozionale (28), intellettuale (33).

I calcoli avvengono qui, solo il rendering; per bi-wheel tutti i pianeti delle due carte vengono calcolati in parallelo (Promise.all).

2026-02-24 — Visualizzazione: rendering SVG (+4 endpoint)

Quattro nuovi endpoint restituiscono rendering SVG di carte natali e visualizzazioni correlate. Server-side puro — senza Puppeteer/headless-Chrome, quindi latenza ~10 ms invece di 1-2 s e gratis per il piano Free.

• POST /v1/render/wheel-western — ruota occidentale (anello dei segni + anello delle case + pianeti + linee degli aspetti).
• POST /v1/render/aspect-grid — matrice triangolare degli aspetti con segno + orb nelle celle.
• POST /v1/render/moon-phase — disco della Luna con illuminazione; restituisce SVG più illuminationFraction, phase, waxing.
• POST /v1/render/timeline — stile Gantt per eventi di transito in un periodo (il chiamante trasmette un array events).

Opzioni: size, theme (light / dark / console), format (json restituisce { svg, byteLength }, svg restituisce direttamente image/svg+xml). Tier base — 2 crediti per chiamata.

2026-02-23 — Schemi tipizzati in /v1/openapi.json (612 endpoint, 98%)

/v1/openapi.json è ora una specifica completa leggibile dalla macchina sia per request bodies che per response data. Tipizzati 612 dei 624 endpoint POST attraverso tre fasi sequenziali che sono atterrate insieme:

• Request bodies — 386 endpoint tipizzati tramite components.schemas (128 componenti riutilizzabili). Tra questi 5 comuni (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) e 123 locali (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern, ecc.). Composizione tramite allOf per l’ereditarietà (DashaInput extends ChartInput).
• Response data — 612 endpoint tipizzati tramite un inferrer che attraversa gli esempi di risposta nel manifesto: {type: 'object', properties: {...}} invece di {type: 'object'} piatto. La carta natale ora dichiara data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] con tipi di campo reali.
• Resto dei 12 endpoint — dasha pratyantar/sookshma con esempi shorthand illeggibili nel manifesto — rimangono {type: object}. Retrocompatibile, li aggiungeremo nei prossimi rilasci.

Cosa significa per l’integratore:

• Rigenera il client OpenAPI — openapi-typescript, openapi-fetch, swagger-codegen creeranno interfacce con campi tipizzati invece di Record<string, unknown>. Il completamento del codice per request bodies + response data funziona nativamente.
• La collezione Postman su /postman/astroway-api.json è stata aggiornata con gli stessi tipi — importala per ottenere l’autocompletamento per tutti gli endpoint tipizzati.

Retrocompatibile: la forma precedente {"type": "object"} era permissiva — tutti i client esistenti continuano a funzionare senza modifiche.

2026-02-21 — Ricalcolo dei prezzi: Reports unificato, Business +500K, Free rafforzato

Tre modifiche di prezzo che influenzano gli integratori:

• Reports unificato a 5.000 crediti — /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitab ridotti da 10.000 cr a 5.000 cr per chiamata (metà prezzo). Tutti i report PDF ora costano lo stesso — matematica più semplice per il budget in batch.
• Piano Business +500K crediti/mese — il piano Business ora dà 3.500.000 crediti al mese (prima 3.000.000) allo stesso prezzo di $199. Gli abbonati esistenti riceveranno il limite aumentato automaticamente dal ciclo di fatturazione successivo.
• Piano Free: /v1/reports/* richiede un piano a pagamento — 12 endpoint PDF (reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) ora restituiscono 402 PLAN_UPGRADE_REQUIRED per le chiavi Free. Il resto delle funzionalità — carte, sinastria, previsioni, oroscopi — rimane disponibile su Free.

Se la tua chiave Free ha chiamato uno di questi endpoint — passa a Indie ($5/mese) o superiore, oppure passa a equivalenti JSON (/v1/chart, /v1/synastry, ecc.) per contenuti simili senza rendering PDF.

2026-02-19 — Autorizzazione tramite Google e GitHub (+2 endpoint)

Un account per tutto l’ecosistema — l’utente che si è registrato su astroway.info o app.astroway.info accede alla console developer tramite la stessa email/SSO, vede la cronologia degli ordini, i crediti e le chiavi API.

• GET /v1/auth/oauth/google/start?return=<path> — avvia il flusso OAuth di Google.
• GET /v1/auth/oauth/github/start?return=<path> — avvia il flusso OAuth di GitHub.

Il callback termina con un redirect a /dashboard/oauth/callback#access_token=&refresh_token=&user= — il dashboard poi persiste i token come dopo /v1/auth/login. Se l’email è già registrata tramite il modulo standard e email_verified=true dal provider — l’account viene collegato, non ne viene creato uno nuovo.

2026-02-17 — Reports Pack ($99 / 500.000 crediti) + white-label incluso

Piano tariffario per gli sviluppatori di report PDF — 100 PDF/mese a $0,99 effettivi, con white-label predefinito:

• Piano reports_pack ($99/mese o $990/anno) dà 500.000 crediti e 200 richieste/minuto.
• Accesso limitato agli endpoint /reports/* (12 tipi di PDF: natale, sinastria, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) + /whitelabel/* (logo personalizzato + colori + dominio). Tutto il resto restituisce 402 PLAN_PACK_MISMATCH (upgrade_to: pro).
• White-label incluso come standard — non serve un upgrade a Enterprise per i PDF brandizzati.
• Sovrapprezzo $3 / 10.000 crediti (come Pro), l’interruttore di limitazione della spesa è disponibile.
• 21 localizzazioni PDF, formato A4, consegna tramite signed-URL CDN (TTL 24 ore).

L’enum del piano API ora è: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack. Nuovo slug WC: astroway-api-reports-pack.

2026-02-15 — Cross-school: Jaimini yogas + Lal Kitab e KP doshas (+17 endpoint)

Diciassette endpoint — completamento della verticale cross-school per yogi e dosha.

• Jaimini Yogas (5) — /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Basati su chara karakas (AK / Amk / PK).
• Varianti Lal Kitab dosha (6) — /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. Differenze specifiche LK e upayas.
• Varianti KP dosha (6) — /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. Regole BPHS + catena sub-lord KP. Sade Sati — consapevole dei transiti (richiede targetDate).

Fonti: Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI. Prezzo: TIER_3 (50 crediti).

2026-02-13 — Vedic Pack ($19 / 100.000 crediti)

Piano tariffario separato per l’astrologia Vedic — 165 endpoint al prezzo di Starter:

• Piano vedic_pack ($19/mese o $190/anno) dà 100.000 crediti e 100 richieste/minuto.
• Accesso limitato ai namespace Vedic (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Tutti gli altri endpoint restituiscono 402 PLAN_PACK_MISMATCH.
• Copertura: 16 varga D1-D60, panchang (7), shadbala (7), yogas (7), doshas (7), compatibilità ashtakoot (6), muhurat (12 categorie), 8 sistemi dasha × 5 livelli (40), KP, Lal Kitab, Jaimini.
• 2,5-5× più carte allo stesso prezzo di Prokerala Ruby (~5K kundli/mese vs loro 1-2K).

L’enum del piano API ora è: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. Nuovo slug WC: astroway-api-vedic-pack.

2026-02-09 — Lal Kitab: pacchetto completo (+12 endpoint)

Dodici endpoint della scuola Vedic North-Indian basati su manoscritti anonimi Urdu 1939-1952. L’intera scuola è YELLOW (intrinseca — single-school con differenze tra autori moderni).

• /vedic/lal-kitab/teva — carta a case fisse (casa = segno).
• /vedic/lal-kitab/lal-kundali — layout a griglia di 12 case.
• /vedic/lal-kitab/kismat + /prosperity — punteggio fortuna & dhana yoga.
• /vedic/lal-kitab/dasha (35y) + /varshphal + /life-graph — timing.
• /vedic/lal-kitab/debts — rilevamento 6 Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) + rimedio.
• /vedic/lal-kitab/remedies — upaya per pianeta (giorno / mantra / donazione).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

Il disclaimer è incluso nelle risposte. Fonti: K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Esoteric Pack ($9 / 200.000 crediti)

Nuovo piano aggiuntivo per gli sviluppatori di esoterica/divinazione — 180 endpoint a $9/mese:

• Piano esoteric_pack ($9/mese o $90/anno) dà 200.000 crediti e 60 richieste/minuto.
• Accesso limitato agli spazi esoterici/divinatori (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Tutti gli altri endpoint restituiscono 402 PLAN_PACK_MISMATCH.
• Non combinabile con altri piani sulla stessa chiave — si tratta di un’estensione separata sul modello del pacchetto HD.

L’enum del piano API ora è: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. Nuovi slug WC: astroway-api-esoteric-pack (varianti mensili + annuali). Se hai creato chiavi tramite /v1/keys senza un piano esplicito — nulla cambia.

2026-02-02 — BaZi + Zi Wei Dou Shu (+17 endpoint)

Terza categoria cinese, dopo Chinese Zodiac + Feng Shui:

• BaZi (5) — /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. I pilastri dell’anno e del mese sono canonici, i pilastri del giorno e dell’ora sono posticipati alla cross-verifica con l’Osservatorio di Hong Kong (fonti diverse danno JD anchor diversi).
• Zi Wei Dou Shu MVP (12) — /ziwei/{twelve-palaces, main-stars, full-chart, palace-destiny, palace-siblings, palace-spouse, palace-children, palace-wealth, palace-health, palace-travel, palace-career, palace-property}. MVP — significati dei palazzi + lista delle 14 stelle principali. La carta completa è posticipata (serve efemeridi lunari specializzate).

L’API ora espone 505 endpoint — parità con il competitor più ampio (Astrology-API.io).

2026-01-30 — Wellness (+9 endpoint)

Nove endpoint wellness — astrologia medica + dieta + yoga + cristalli ecc. Solo uso educativo — non è un consiglio medico, disclaimer in ogni risposta.

• POST /v1/wellness/medical-astrology — governo del corpo secondo la Melothesia tradizionale.
• POST /v1/wellness/diet — cibo per elemento (focus / enfatizza / evita).
• POST /v1/wellness/yoga — focus + asana + pranayama per segno.
• POST /v1/wellness/exercise — intensità + raccomandazioni/evitamenti per elemento.
• POST /v1/wellness/mental-health — profilo elementare + elemento dominante + punti di forza/debolezza + coping.
• POST /v1/wellness/sleep-cycles — consigli per il sonno in base alle fasi lunari.
• POST /v1/wellness/herbs — erbe secondo il governatore planetario del segno (Culpeper 1653).
• POST /v1/wellness/crystals — cristalli per segno + intenzioni.
• POST /v1/wellness/cycle — pietre miliari wellness in base all’età (Saturn return, opposizione di Urano, …).

Fonti: Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Tier — 2 crediti (cycle = 1 credito).

2026-01-27 — Calendari maya (+8 endpoint)

Blocco maya: Tzolkin classico + Haab + Long Count + Calendar Round + Signore della Notte, più Dreamspell (Argüelles moderno 1990).

• POST /v1/mayan/tzolkin — calendario sacro di 260 giorni (numero 1-13 + nome dei 20).
• POST /v1/mayan/haab — calendario civile di 365 giorni (18 mesi × 20 + 5 giorni Wayeb).
• POST /v1/mayan/long-count — notazione posizionale a 5 cifre baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round — combinazione Tzolkin+Haab (ciclo di 52 anni).
• POST /v1/mayan/lord-of-night — ciclo di 9 giorni (G1-G9).
• POST /v1/mayan/full — tutto il classico in una singola chiamata.
• POST /v1/mayan/compatibility — compatibilità di coppia per tono/nome/elemento/direzione.
• POST /v1/mayan/dreamspell — Dreamspell moderno di Argüelles (kin 1-260, tono × sigillo).

Fonte: correlazione Goodman-Martínez-Thompson (Thompson 1935 + Lounsbury 1976). Validazione anchor: 2012-12-21 = Long Count 13.0.0.0.0 ✓ (rollover di Bak’tun).

2026-01-23 — Sthira + Shoola Dasha (+10 endpoint)

Due scuole Jaimini rasi-dasha con cascata completa (maha, antar, pratyantar, sookshma, prana):

• Sthira — seed = segno del pianeta Brahma, MD forward 12 segni (7y movable / 8y fixed / 9y dual).
• Shoola — seed = stronger_rasi(asc, asc+6), MD forward 12×9y, opzione antardasaSeedOption ∈ 3.

Completamento del set di 10 scuole dasha × 5 livelli = 50 endpoint. Fonti: BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

2026-01-19 — Pet + Business + Financial (+36 endpoint)

Tre categorie in un’unica spedizione:

• Pet (14) — /pet/{birth-chart, sun-sign-meaning, personality, temperament, training-style, diet-by-sign, grooming-by-element, exercise-needs, communication-style, play-style, health-tips, best-names, lucky-day, owner-pet-compatibility}. Disclaimer: solo intrattenimento — non cure veterinarie.
• Business (12) — /business/{founder-personality, leadership-style, ideal-industry, founding-chart, electional-day, name-suggestions, team-compatibility, customer-archetype, marketing-style, risk-profile, ideal-partner-sign, expansion-timing}. Disclaimer: ideazione strategica, non consulenza legale/fiscale.
• Financial (10) — /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}. ⚠️ NOT INVESTMENT ADVICE — disclaimer rafforzato in ogni risposta.

Tier — 2 crediti (market-timing/wealth-cycle finanziario = 3 crediti).

2026-01-16 — Suite di analisi Jaimini (+10 endpoint)

Dieci endpoint di analisi Jaimini — chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK in D9), riepilogo dasha in esecuzione, basic Jaimini yogas.

Fonti: Jaimini Sutras 1-2 + BPHS Adhyayas 26/47.

2026-01-09 — Status page + agenti AI + URL base predefinito

• Pagina di stato pubblica: https://api.astroway.info/status — uptime, latenza p50/p95/p99, cache ogni 60s.
• llms.txt per agenti AI: https://api.astroway.info/llms.txt — istruzioni strutturate per agenti Claude / ChatGPT / Perplexity Code.
• URL base predefinito nella documentazione, server MCP, SDK, collezione Postman — api.astroway.info/v1 (con redirect 301 dal vecchio api-calc.astroway.info).

2025-12-30 — Tribhagi, Shatabdika, Shodashottari Dashas (+15 endpoint)

Tre sistemi dasha nakshatra con cascata completa:

• Tribhagi — scala 1/3 di Vimshottari (ciclo di 40 anni).
• Shatabdika — ciclo di 100 anni, 7 pianeti (senza shadow).
• Shodashottari — ciclo di 116 anni, 8 pianeti (senza Ketu).

Fonti: BPHS Adhyaya 46.

2025-12-25 — Piani tariffari in crediti: riequilibrio a 5-tier + Free 5K → 10K

Ricalibrato i tier dei crediti dopo un audit su 18 competitor. Il piano Free ora dà 10.000 crediti al mese (prima 5.000). Le percentuali di spesa per i casi d’uso tipici (carta natale + 7 transiti) sono state ridotte di ~22%. Nessun breaking change nell’API — solo l’economia.

2025-12-17 — Zodiaco cinese + Feng Shui Kua (+8 endpoint)

Primo blocco di astrologia cinese, livello base (BaZi + Zi Wei Dou Shu in seguito):

• POST /v1/chinese/zodiac/animal — animale dell’anno + pilastro completo (Geng-Wu, Legno-yang, ecc.).
• POST /v1/chinese/zodiac/element — elemento fisso + ciclico Wu Xing con yin/yang.
• POST /v1/chinese/zodiac/inner-animal — animale interno (ramo del mese).
• POST /v1/chinese/zodiac/secret-animal — animale segreto (ramo dell’ora — serve time).
• POST /v1/chinese/zodiac/compatibility — compatibilità di coppia tramite coppie San He / conflitto Liu Chong.
• POST /v1/chinese/feng-shui/kua — numero Kua personale + gruppo Est/Ovest.
• POST /v1/chinese/feng-shui/lucky-directions — 4 direzioni fortunate + 4 sfortunate secondo la bussola.
• POST /v1/chinese/feng-shui/bagua — mappa Bagua di 9 sfere della vita con elementi + colori.

Fonte: canonico 60-jiazi + L. Skinner Living Earth Manual (1976) + Lillian Too. Tier — 2 crediti per chiamata. Taglio Lichun = 4 febbraio (precisione ±1 giorno per 1900–2100).

2025-12-09 — Quality pass: 24 bug fix nelle categorie Vedic

Fissati 24 bug di calcolo tramite 6 agenti deep-research paralleli. I più critici: cancellazione Mangal dosha (Marte in esaltazione cancella per BPHS), trigger Pitru dosha (Sole-Saturno vs Sole-Rahu), deriva ARMC composita di Davison, precisione della linea meridiana ACG. Aggiunti snapshot test: 47.

2025-12-02 — Compatibilità Vedic + Muhurat (+18 endpoint)

• Compatibilità (6) — abbinamento Ashta-Koota (Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi) + compatibilità Mangal dosha + riepilogo Bhrigu.
• Muhurat (12) — elezioni per matrimonio, business, viaggio, istruzione, chirurgia, mahurta-types (abhijit, vijaya, amrit, brahma).

Fonti: BPHS + Muhurta Chintamani.

2025-11-29 — KP (Krishnamurti Paddhati): pacchetto completo (+10 endpoint)

Dieci endpoint della scuola canonica KP (K.S. Krishnamurti 1971).

• /vedic/kp/{cusps, sub-lords, planet-cuspal-position} — cuspidi Placidus + catena a 4 livelli di sub-lord (segno / stella / sub / sub-sub).
• /vedic/kp/ruling-planets — catena Day/Hora + Asc + Luna, deduplicata.
• /vedic/kp/horary — numero orario KP 1..249 → lookup longitudine ASC.
• /vedic/kp/significators — significatori primari/secondari/terziari per pianeta.
• /vedic/kp/sub-sub-lord — catena a longitudine siderale arbitraria.
• /vedic/kp/asc-sub — sub-lord dell’Ascendente.
• /vedic/kp/fortuna — Part of Fortune (giorno/notte) + catena KP.
• /vedic/kp/transit-kp — posizioni al momento corrente + catena KP.

Algoritmo: suddivisioni proporzionali Vimshottari (27 stelle × 9 sub-lord). Fonti: K.S. Krishnamurti Reader I-VI (1971-77).

2025-11-22 — Vimshottari + Yogini + Ashtottari + Kalachakra Dashas (+20 endpoint)

Quattro sistemi classici di dasha vedici con cascata completa (maha, antar, pratyantar, sookshma, prana):

• Vimshottari — ciclo di 120 anni, 9 pianeti.
• Yogini — ciclo di 36 anni, 8 yogini.
• Ashtottari — ciclo di 108 anni, 8 pianeti (senza Ketu), tradizione Ardradi.
• Kalachakra — dasha basata sul segno, paramayu varia per pada (100/85/83/86).

Fonti: BPHS Adhyaya 46 + Saravali. Cross-validato contro PyJHora 7.02.

2025-11-08 — Chara Dasha (Jaimini K.N. Rao) (+5 endpoint)

Scuola rasi-dasha Jaimini nella variante K.N. Rao (1995). Direction = forward per segni lagna mobili/doppi, reverse per segni fissi. Regola co-lord per Scorpione (Marte+Ketu) e Acquario (Saturno+Rahu).

2025-10-25 — Server MCP + gateway AI

• Server MCP @astroway/mcp — Model Context Protocol per Claude $1, Cursor, Cody. Ogni endpoint API è disponibile come strumento MCP.
• Gateway AI — un microservizio privato separato ai.astroway.info gestisce le richieste LLM con un provider chain (Gemini Flash → Groq Llama → OpenRouter → Cerebras → SambaNova → Mistral).
• Lo SDK TypeScript è atteso in un rilascio separato — per ora usa il codegen OpenAPI su https://api.astroway.info/v1/openapi.json (openapi-typescript / openapi-fetch danno un client tipizzato con 612 coppie request/response tipizzate).

2025-10-08 — Yogas + Doshas Parashara Vedic (+14 endpoint)

• Yogas (7) — Raja, Dhana, Dharma-Karmadhipati, Pancha-Mahapurusha, Gajakesari, Adhi + composite.
• Doshas (7) — Mangal, Kaal Sarp, Pitru, Shrapit, Grahan, Guru-Chandal + composite.

Fonti: BPHS Adhyayas 36-39, Phaladeepika.

2025-08-10 — Vargas Vedic D1-D60 + Panchang + Shadbala (+31 endpoint)

• 16 Vargas D1-D60 (16) — da Rasi (D1) a Shashtiamsa (D60), per BPHS Adhyaya 7.
• Panchang (8) — tithi, vara, nakshatra, yoga, karana + alba/tramonto, abhijit, rahu kaal.
• Shadbala (7) — 6 fonti di forza per pianeta + composite (Sthana, Dig, Kala, Cheshta, Naisargika, Drig).

2025-05-18 — Dizionari esoterici + Crystal/Angel/Dream (+30 endpoint)

Estensione dei dizionari di riferimento: 15 concetti esoterici (chakra, kosha, tattva, guna) + 15 tabelle di lookup per cristalli/angeli/sogni. Cache su edge (Cloudflare R2).

2025-03-12 — Glossario di riferimento + Tarot Lenormand (+24 endpoint)

• Reference (14) — dizionari di segni, pianeti, case, aspetti, nakshatra, stelle fisse, simboli sabiani.
• Tarot Lenormand (10) — sistema a 36 carte: single, 3 carte, 9 carte, Grand Tableau, per domanda.

2024-11-15 — Tarot Marseille (+20 endpoint)

20 endpoint del mazzo di Marsiglia: spread (single, 3 carte, Cross, 5 carte, Croce celtica, anno a venire), significati delle carte, modalità invertita, per domanda. Fonti: riferimenti pubblici Camoin / Jodorowsky.

2024-08-25 — Numerologia — pacchetto completo: Pitagorica + Caldea + Cabalistica + Vedica (+40 endpoint)

Quattro sistemi numerologici × 10 endpoint ciascuno: life path, expression, soul urge, personality, compleanno, maturità, anno/mese/giorno personale corrente, compatibilità dei nomi.

Fonti: Pitagorica (Cheiro 1908), Caldea (Cheiro), Cabalistica (gematria ebraica), Vedica Caldea Indiana.

2024-05-08 — Tarot Rider-Waite-Smith (+35 endpoint)

35 endpoint del mazzo RWS: tutti gli spread canonici (single, 3 carte, Croce celtica, anno a venire, relazione, ferro di cavallo a 5 carte, ellisse a 7 carte, decisione, situazione, mensile), significati delle carte (diritta + invertita), per domanda, carta del giorno, mescolanza del mazzo.

Fonti: immagini Smith PD dal 2021, Waite Pictorial Key 1909 PD.

2024-02-20 — Generazione di oroscopi AI + interpretazioni (+12 endpoint)

Generazione di interpretazioni in linguaggio naturale:

• /horoscope/{daily, weekly, monthly} — oroscopi testuali.
• /interpret/{natal, transit, synastry, compatibility} — interpretazioni dettagliate.

Catena di provider: GPT-4 → Anthropic Claude → fallback Groq.

2023-11-28 — Destiny Matrix (Ladini) (+1 endpoint)

/destiny-matrix/ladini — sistema di Natalia Ladini (mercato russo/CIS). Metodo di un singolo autore con disclaimer esplicito.

2023-09-20 — Timeline degli aspetti + armoniche + indice ciclico (+12 endpoint)

Analisi avanzata degli aspetti:

• /aspect-timeline — momenti esatti degli aspetti nei prossimi N giorni.
• /harmonics/{2..12} — carte armoniche.
• /cyclic-index — indice ciclico delle tensioni sociali di André Barbault.
• /sabian-symbols — 360 simboli di Marc Edmund Jones.

2023-05-10 — Astrocartografia + Spazio Locale + Geodetica (+18 endpoint)

Geo-astrologia:

• /acg + /acg-zones — linee astrocartografiche dei pianeti.
• /local-space — orizzonte Spazio Locale.
• /parans — parans (Bernadette Brady).
• /relocation — carta di relocation.
• /zenith + /horizon + /geodetic — motori geo aggiuntivi.
• /ccg-analysis — analisi CCG/CMG geo dettagliata.

Fonti: Jim Lewis Astro*Carto*Graphy, Sepharial Theory of Geodetic Equivalents, Bernadette Brady.

2023-02-15 — Modulo Human Design (+12 endpoint)

Motore completo Human Design:

• /human-design — bodygraph (gates, canali, centri, tipo, profilo, autorità, strategia, ambiente, prospettiva).
• /hd/incarnation-cross — croce di incarnazione + 4 gate.
• /hd/{channels, gates, profiles, definition, authority, strategy, environment, perspective, mental-projector, ecc}.

Fonti: Ra Uru Hu The Human Design System + Chetan Parkyn + Lynda Bunnell.

2022-08-20 — Sinastria + composite server-side

Astrologia relazionale (sinastria, composite, Davison) implementata lato server. I primi endpoint disponibili tramite /v1/synastry, /v1/composite, /v1/davison. Marcatore di estensione all’analisi relazionale.

Validato contro Solar Fire / Astrodienst — deriva entro il margine di errore del metodo (≤0,5″ su calcolo medio).

2022-07-28 — Sinastria, composite, Davison + sinastria di gruppo (+5 endpoint)

• /synastry — confronto relazionale con matrice degli aspetti.
• /composite — composite midpoint di Robert Hand.
• /davison — composite tempo-luogo di Ronald Davison.
• /group-synastry — matrice sinastria multi-persona (3+).

Fonti: Hand Planets in Composite, Davison Synastry, Lois Sargent.

2022-04-15 — SPA app.astroway.info — prodotto consumer live

Lanciato app.astroway.info — SPA in React/TypeScript che si collega al backend tramite /v1/*. Account utente, carte salvate, preferiti. Marcatore del passaggio da sito-only a prodotto completo.

Lo stesso backend diventa poi la base dell’API pubblica.

2022-03-18 — Dignità essenziale + ricezioni + almuten + parti arabe (+13 endpoint)

Astrologia classica:

• /essential-dignities — domicilio, esaltazione, triplicità, termini, facce.
• /receptions — rilevamento di ricezione reciproca.
• /almuten — Almuten Figuris (regolo della carta).
• /arabic-parts — Lotti della Fortuna, dello Spirito, di Eros, della Necessità e altri 30+ Lotti ellenistici.
• /hyleg — hyleg + alcocoden.
• /algol-minimum + /fixed-stars — stelle fisse.

Fonti: Lilly Christian Astrology + Brennan Hellenistic Astrology.

2021-08-10 — Calendario dei transiti + calendario previsionale + ritorno di fase (+10 endpoint)

• /transit-calendar — momenti esatti dei transiti nei prossimi 6/12 mesi.
• /forecast-calendar — previsioni mensili.
• /phase-return — solar return, lunar return, Saturn return, Jupiter return.
• /eclipse-analysis — eclissi nel contesto della carta natale.

2021-04-05 — Calcolo degli aspetti + espansione dei sistemi di case (+8 endpoint)

• /aspects — matrice completa degli aspetti con tabelle orb (Tolomeo, moderno, asteroidi).
• /coalescent — punti coalescenti.
• /disposition-chains — catene di governo dei pianeti.
• Espansione dei sistemi di case: Placidus, Koch, Uguale, Whole, Campanus, Regiomontano, Topocentrico, Porfirio, Alcabizio, Morinus.

2020-07-10 — Matrice degli aspetti + aspetti classici

Suite di calcolo stabilizzata. /v1/aspects pronto: supporto per congiunzione, opposizione, quadrato, trigono, sestile con orb tolemaici. Fondamento per tutta l’analitica successiva (transiti, sinastria, returns).

L’assembly WASM di Swiss Ephemeris è stato definitivamente integrato — ~5x più veloce rispetto al modello analitico precedentemente utilizzato.

2020-06-15 — Testo oroscopo daily/weekly (+4 endpoint)

• /horoscope/daily/{sign} — oroscopo giornaliero per ogni segno zodiacale.
• /horoscope/weekly + /horoscope/monthly — settimanale / mensile.
• /sun-signs — significati dei segni solari.

Il testo viene generato dal team editoriale manuale (i testi LLM-augmented arriveranno in seguito nel 2024).

2020-03-20 — Sinastria beta + extras efemeridi (+5 endpoint)

• /synastry-beta — sinastria iniziale (rilascio completo nel 2022).
• /ephemeris/{planets, asteroids, lunar-nodes} — storico 1900-2100.
• /extra — stelle fisse, Lilith Nera, Chirone.

2020-02-20 — Skeleton API REST + OpenAPI 2.0

Specifica interna OpenAPI 2.0 pubblicata. Primo namespace /v1/*. Autenticazione tramite header X-Api-Key. Infrastruttura di rate limiting pronta.

Traguardo interno — l’API pubblica verrà lanciata in seguito, ma il contratto è stabile da questo momento.

2019-12-15 — Motore di calcolo /chart interno

Prima implementazione server-side di /chart (privata). Case Placidus, offset siderali, calcolo dei pianeti, stelle fisse. Test contro baseline Astro.com.

Completamente Node.js — abbandono definitivo della logica PHP-only precedente.

2019-09-25 — Rilascio iniziale

Prima release pubblica dell’AstroWay Astrology API. Funzionalità base:

• /chart — carta