Changelog what is new

Toate modificările care afectează codul integratorului: noi endpoint-uri, actualizări SDK, modificări în /openapi.json, corecturi de preț în credite, deprecieri, modificări cu efecte asupra funcționării. Cele mai recente — de sus.

Contractul API este stabil în cadrul /v1/* — orice modificare cu efecte asupra funcționării este lansată sub /v2/*, iar /v1/* continuă să funcționeze cel puțin 12 luni.

2026-05-16 — Endpoint-ul MCP găzduit live la mcp.astroway.info/mcp

@astroway/mcp este acum disponibil în două moduri de transport. Modul Stdio (pachet npm) rămâne neschimbat; a fost adăugat un endpoint HTTP găzduit pentru integrare zero-instalare în Claude $1 (claude.ai în browser), Claude $1, Cursor, Cline și alți clienți compatibili MCP.

Instalare cu un singur clic pentru Cursor — butonul cursor://anysphere.cursor-deeplink/mcp/install?... pe pagina /examples/mcp/. Claude $1 — prin + → Add Connector → Custom (fără editare JSON).

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

Aceeași colecție de 630 de unelte + 12 prompturi + 14 resurse, aceeași autentificare aw_test_* / aw_live_* (în modul găzduit, prin antetul Authorization: Bearer … în loc de variabilă de mediu), aceeași piscină de credite. Multi-tenant din proiectare — fiecare cerere conține cheia sa, creditele fiind debitate din contul proprietarului cheii. Canalul din X-Astroway-Channel — mcp-http (găzduit) vs mcp (stdio) pentru urmărirea adoptării.

De ce două moduri. Stdio (npx @astroway/mcp) rămâne pentru utilizatorii avansați Cursor / integratori conștienți de confidențialitate — cheia nu părăsește niciodată mașina, fără hopuri de rețea. Găzduitul acoperă segmentul Claude $1 (care suportă doar MCP remote) și scenariile de instalare zero.

Endpoint-ul de stare — accesibil public fără autentificare:

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

Documentația completă a ambelor moduri — /examples/mcp/.

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

Introspecție a cheii API. Trimiteți X-Api-Key — primiți starea completă: plan, credite, stare, domeniu asociat, dată de creare, sursă de înregistrare. Util pentru consumatorii de SDK (TS / Python / PHP / MCP) — “ce cheie am în acest moment” fără a citi dashboard-ul. Analog Stripe /v1/account sau GitHub /user.

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # primele 11 caractere, cheia completă nu este returnată niciodată
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # sfârșitul calendaristic al lunii
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # domeniu la care cheia este asociată (chei wp-plugin)
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

Fără autentificare: 401 MISSING_API_KEY. Cheie nevalidă: 401 INVALID_API_KEY.

Specificație OpenAPI 3.1. /v1/openapi.json declară acum /v1/auth/keys/me. Generarea de cod SDK (openapi-typescript, openapi-generator-cli) va completa automat client.auth.keys.me() în următoarea regenerare.

Compatibilitate inversă. Vechiul GET /v1/keys/usage (care returna doar credits_today + ratelimit) continuă să funcționeze — acesta este un endpoint separat pentru verificări cron pe server. /auth/keys/me returnează starea completă plus asocierea domeniului pentru scenarii wp-plugin.

2026-05-14 — Localizarea /horoscope/* și /interpret/* (21 de limbi)

POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility} și POST /v1/interpret/{natal,synastry,transits,element,placement} — 10 endpoint-uri care returnează textul interpretării — acum returnează răspunsul în limba clientului.

Cum se conectează:

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"}'
# → răspuns în हिन्दी

Prioritate de rezolvare (server-side):

1. body.language="de" — parametru explicit per-cerere (prioritate mai mare)
2. Accept-Language: de, en;q=0.7 — greutate q din RFC 7231; primul cod care se potrivește cu limba activă câștigă
3. ?lang=de — parametru de interogare pentru clienții care nu controlează antetele
4. Fallback → uk (limba sursă)

Limbile suportate (21): uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id. Coduri necunoscute cad în mod liniștit în uk fără erori.

Specificație OpenAPI 3.1. /v1/openapi.json declară acum Accept-Language (antet) și lang (parametru de interogare) ca parametri cu enum 21 de coduri pe aceste 10 endpoint-uri. Generarea de cod SDK (openapi-typescript, openapi-generator-cli) va completa automat apeluri tipizate .lang('hi') în următoarea regenerare.

Ce se traduce: doar câmpurile text ale interpretării (horoscope, interpretation, disclaimer etc.). Câmpurile numerice (longitude, latitude, score, ID-uri de semne, ID-uri de case) rămân canonice — clientul le formatează local. Standard de segment.

Scop: pentru moment, sunt localizate 10 endpoint-uri din grupul de interpretare. Endpoint-urile de calcul (/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690 de alte endpoint-uri) returnează numere și identificatori canonici (name: "Aries", glyph: "♈") neschimbate — clientul le localizează prin tabelele sale de căutare. Acesta este standardul de segment.

Compatibilitate inversă. Codul existent fără Accept-Language / ?lang= / body.language primește uk implicit, ca și înainte.

Suportul SDK (@astroway/sdk, astroway, astroway/sdk, @astroway/mcp) adaugă opțiunea lang în constructor — lansări separate vin în următoarele săptămâni prin cron-applier pe repozitorii de staging.

2026-05-09 — Trei SDK-uri lansate: TypeScript, Python, PHP

Trei SDK-uri oficiale trăiesc în registre publice — învelișuri în jurul acelorași 700+ de endpoint-uri API. O singură specificație OpenAPI 3.1 → trei clienți idiomatice pentru limbaje.

Ce este acest lucru pentru integrator:

• Alternativă tipizată la HTTP brut. Autocompletare a căilor + tipuri de cereri și răspunsuri în IDE. Metode ajutătoare aw.post('/chart', body=...) (Python/PHP) sau aw.client.POST('/chart', { body }) (TS) — în loc de fetch / requests / Guzzle manual.
• Suprafață identică pe limbaje. Constructor Astroway({apiKey, baseUrl, authScheme, timeout, retry}) funcționează la fel în TS / Python / PHP. Dacă proiectul dvs. este multilingv — mai puțină încărcare cognitivă.
• Reîncercare încorporată pe 408/409/429/5xx cu backoff exponențial + jitter complet. Respectă antetul Retry-After. Reîncercări implicite 2, configurabile prin retry={maxRetries: 0}.
• Ierarhie de erori fără cusur — același model ca în SDK-urile Stripe / OpenAI / Cloudflare. Prindeți RateLimitError (cu retryAfterSeconds), AuthenticationError (rotați cheia), BadRequestError (validare), ApiError (generic) — în acest ordin.
• Două scheme de autentificare. Implicit X-Api-Key: aw_live_... (ca în curl/Postman). Sau Authorization: Bearer aw_live_... (ca în SDK-urile Stripe/OpenAI/Anthropic) — auth_scheme="bearer" în constructor.
• Antete de identificare, fără telemetrie. Fiecare cerere poartă User-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>. Fără phone-home, fără comutator de opt-in/opt-out.
• OIDC + SLSA L3 proveniență (TS + Python). Înregistrare atestată de pachet construit dintr-un anumit commit în repozitoriu public. Fără tokenuri cu durată lungă de viață în CI.
• MIT, sursă deschisă completă pe github.com/astroway/{astroway-typescript,astroway-python,astroway-php}.

Pornește rapid:

// 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', /* ... */]);

Variantă asincronă pentru Python — AsyncAstroway cu suprafață identică prin async/await. În PHP — doar sincron (PHP nu are o poveste unificată asincronă). În TS — promisiuni native pe baza openapi-fetch.

Acesta este alpha — API-ul public poate fi modificat până la 0.1.0 corespunzător pe baza feedback-ului integratorilor. Fixați versiunea exactă (@astroway/sdk@0.1.0-alpha.1) în timpul ferestrei alpha — sau cea mai recentă alpha la momentul instalării.

@astroway/mcp — server MCP pentru Claude / Cursor / GPT — continuă să trăiască alături ca produs separat.

2026-05-07 — Actualizare server MCP

@astroway/mcp a fost actualizat — generează automat catalogul de unelte din /openapi.json curent fără editare manuală. Tot ceea ce a apărut în API în ultimele săptămâni (suite de compatibilitate, endpoint-uri de rapoarte) este imediat vizibil în Claude / Cursor / GPT.

Pentru integrator:

• Catalogul de unelte reflectă starea curentă a API-ului
• Endpoint-urile cu șablon de cale (/v1/.../id) sunt ocolite pentru moment, pentru a nu confunda parserul de descriere
• Anotări de cost în descrierea uneltei — Claude vede costul apelului înainte de executare
• Publicare OIDC de încredere + proveniență SLSA L3 — pachetul este atestat până la un anumit commit în repozitoriul public astroway/astroway-mcp

Instalare:

npm install -g @astroway/mcp

Sau prin Claude $1 / Cursor MCP config:

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

Sursă: repozitoriu public astroway/astroway-mcp (MIT).

2026-04-11 — Compatibilitate între sisteme (+10 endpoint-uri)

Un nou grup /v1/compat/* — scor de compatibilitate unificat între sistemele occidentale, vedice, chinezești, numerologice, tarot, design uman. 6 sisteme oferă o metrică unificată pentru indicatori UX în aplicații astrologice multi-tradiționale.

Fiecare endpoint returnează un JSON cu câmpul disclaimer — aceasta este metodologia de scorare AstroWay, nu o afirmație clinică sau juridică. Nivel 4 (100 de credite) pe apel — calcul intensiv transversal.

Manifestul pe /openapi.json a fost actualizat — SDK / MCP vor prelua automat.

2026-03-28 — Rapoarte + Webhook-uri (+17 endpoint-uri)

Două noi grupuri în producție.

/v1/reports/* (12 endpoint-uri) — generare de rapoarte HTML / PDF prin Puppeteer. Render pe partea serverului de calcul, URL de descărcare semnat (TTL 24h).

/v1/webhooks/* (5 endpoint-uri) — gestionare de abonamente, livrare de evenimente, semnătură HMAC. Abonare la evenimente 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_..."}'

Fiecare livrare poartă X-Astroway-Signature: sha256=<hmac> — verificați prin secret. Politică de reîncercare: backoff exponențial pe 5xx, până la 5 încercări în 24 de ore.

2026-03-14 — Endpoint-uri de referință: publice, fără cheie, fără credite

14 endpoint-uri /v1/reference/* (semne, planete, case, aspecte, elemente, modalități, polarități, demnități, decane, nakshatra, loturi, asteroizi, sisteme zodiacale, glife) funcționează acum fără X-Api-Key și costă 0 credite. Acestea sunt tabele de căutare canonice — a le factura prin facturare a fost o supraveghere a proiectului.

Ce este acest lucru pentru integrator:

• Apel fără cheie — agenți externi MCP / SDK / pagini de previzualizare pot trage date de referință fără autentificare. Limitarea rate-ului IP (30 de cereri / oră) rămâne.
• Manifest de cost actualizat — 14 căi trec de la TIER_HALF (5 credite) la 0. Dacă planul dvs. de bugetare astroway_cost_estimate se referă la aceste căi — noile apeluri nu afectează cota.
• Clienți existenți cu cheie funcționează fără modificări. X-Api-Key este ignorat pentru /reference/* (nu suntem atenți la antetul suplimentar).

Compatibilitate inversă: răspunsurile 200 și schema JSON nu se schimbă, doar cerința de autentificare este eliminată.

2026-03-07 — Oferta pe viață a fondatorilor: 299 $ → tarif Indie pe viață

Lansăm Oferta pe viață a fondatorilor — lansare limitată. Primii 100 de clienți plătesc 299 $ o singură dată și primesc tariful Indie (50.000 de credite/lună) pe viață, fără debite recurente, cu preț fix.

Ce este acest lucru pentru integratori:

• Tarif standard Indie = 5 $/lună. Fondatori = o singură dată 299 $ → punct de rentabilitate la 5 ani, după care ROI nelimitat. Dacă proiectul dvs. durează cel puțin 5 ani în astrologie / numerologie / Tarot — Fondatori se plătesc.
• Payload webhook la checkout SKU astroway-api-indie-lifetime: șirul api_keys primește plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. Fără debite lunare, fără webhooks de reînnoire.
• Schema bazei de date: adăugate coloane is_lifetime TINYINT(1) în api_keys și shared_user_quotas. Tipul TS ApiKeyInfo a fost extins. Cheile existente = is_lifetime=0 (fără schimbare de comportament).
• WP REST endpoint GET /wp-json/astroway/v1/founders-count returnează {sold, total: 100, remaining, available} — utilizat în componenta site-ului /founders/FoundersCounter.astro pentru numărător în timp real pe pagina /founders/.
• Dezactivare automată la 100/100: starea stocului produsului WC trece automat în outofstock prin hook-ul WC woocommerce_order_status_completed. După aceasta, linkul de checkout se redirecționează către /pricing/#indie (tarif standard Indie 5 $/lună).

Pagini live: /founders/ (uk) + /en/founders/ (en). Intrare în bara laterală “Oferta pe viață a fondatorilor” cu badge 100 doar.

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

2026-03-05 — Pagină de aterizare GDPR / Rezidență UE + Badge Pro UE

Lansăm /eu/ — o pagină separată pentru dezvoltatorii UE a căror produs este sensibil la GDPR. Integratorul trebuie să știe:

• Pro 59 $ = Rezidență UE implicită (Hetzner Nuremberg, flux de date doar în interiorul UE, analitică anonimă — Plausible cookie-free în drum).
• Acord standard DPA disponibil nu doar pe Enterprise — semnat prin e-mail pe tarif standard Pro în 5 zile lucrătoare.
• DELETE /v1/me/account — endpoint pentru dreptul la ștergerea datelor cu caracter personal (ștergeți instantaneu wp_user_id din toate tabelele).
• Cartea Pro pe /pricing/ are acum un badge 🇪🇺 GDPR-ready — faceți clic pe /eu/ cu FAQ complet.
• DivineAPI / AstrologyAPI / Prokerala — găzduire SUA / India, DPA doar pe Enterprise. Dacă conformitatea GDPR este critică — Pro 59 $ este cel mai ieftin drum.

Pagini: /eu/ (uk) + /en/eu/ (en). Înregistrare în navigarea laterală “GDPR / Rezidență UE” cu badge 🇪🇺.

2026-03-03 — Plată anuală −25% + transfer de credite + caracteristici Pro publice

Două schimbări care afectează codul integratorilor:

• Reducere anuală 17% → 25% (3 luni gratuite în loc de 2). Noile prețuri în USD pe an: Indie 45 $, Starter 171 $, Pro 531 $, Business 1791 $, Pachet HD/Esoteric 81 $, Pachet Vedic 171 $. Prețurile existente pentru abonamente anuale nu sunt afectate — noul preț se aplică doar reînnoirilor viitoare de abonament. Dacă ați parsat prețurile în USD prin /wp-json/astroway/v1/api-prices — valorile actualizate sunt returnate acum automat.
• Transfer de credite pentru abonații anuali: creditele neutilizate trec în următorul ciclu lunar, limitate la 1 × limita lunară a tarifului. Se activează automat la achiziționarea unui plan anual. Vizibil prin noi antete de răspuns:
  • X-Credits-Limit: <int> — limită lunară eficientă (inclusiv transfer)
  • X-Credits-Remaining: <int> — cum a fost, dar cu transfer
  • X-Credits-Rollover: <int> — soldul curent de credite transferate (doar pentru anuale)
• Caracteristici Pro ($59) acum promovează deschis: endpoint-uri de streaming (în timp real), conformitate GDPR UE, MCP extins (multi-agent / dezbateri / RAG), webhook-uri (10 tipuri). Acestea sunt funcții care au existat deja în Pro — anterior erau ascunse în documentație.

Schema bazei de date: adăugate coloane credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED în api_keys și shared_user_quotas. La început — ambele = 0 pentru toate cheile existente.

2026-03-01 — Tabel de prețuri transparent pentru credite pe endpoint

Lansăm pagina publică /credits/ cu o defalcare completă a creditelor pe toate cele 700+ de endpoint-uri. Niciun concurent (DivineAPI, AstrologyAPI, Prokerala) nu publică un astfel de tabel — ei iau un credit fix pe apel și ascund rutarea internă.

Pentru integrator, acest lucru oferă trei lucruri:

• Unitate economică transparentă — costul exact $/apel pentru fiecare endpoint (bugete lunare /pricing/ × prețul tarifului = costul real pe apel).
• Sincronizare automată cu codul — tabelul este generat în timpul construirii din endpoint-costs.ts. Dacă adăugăm un nou endpoint sau schimbăm tariful — pagina se actualizează automat la următoarea implementare.
• Marcator pentru planul gratuit — coloana arată care endpoint-uri necesită Indie+ (simbol 🔒, 28 de endpoint-uri în prezent).

Disponibil: /credits/ (uk) și /en/credits/ (en). Legături încrucișate cu /rate-limits-credits/ și înregistrare în navigarea laterală Starlight (simbol “Nou”).

2026-02-27 — Vedic-hartă, cosmogramă, eclipsă-călătorie, hartă-stea (+6 endpoint-uri)

Închide categoria Vizualizare la 14/14 de endpoint-uri conform planului de drum:

• POST /v1/render/wheel-vedic-north — layout nord-indian (diamant). Casele sunt fixe, semnele se rotesc după lagne.
• POST /v1/render/wheel-vedic-south — layout sud-indian (4×4 grid). Semnele sunt fixe (Pești în partea superioară stângă), casele plutesc.
• POST /v1/render/wheel-vedic-east — layout est-indian (Bengali). Pătrat cu diagonale + pătrat interior rotit.
• POST /v1/render/cosmogram — 90°-diametru (Ebertin 1940 + Witte 1928).
• POST /v1/render/eclipse-path — hartă equirectangulară a lumii cu traseul lat/lon furnizat de apelant; renderizează linia centrală + benzile de lățime specificate.
• POST /v1/render/star-map — proiecție stereografică a listei de puncte (RA/Dec) cu scalare de magnitudine.

Toate renderările — pur SVG, fără headless-Chrome.

2026-02-25 — Bi-roată + compusă + bio-ritm (+4 endpoint-uri)

Patru noi endpoint-uri de vizualizare care extind mecanica SVG:

• POST /v1/render/bi-wheel — două cercuri concentrice: intern natal + extern cu planete tranzitare (sau progresate).
• POST /v1/render/tri-wheel — trei cercuri: natal + progresat + tranzit.
• POST /v1/render/composite — hartă compusă din două date de naștere (punctul de mijloc al compusului).
• POST /v1/render/biorhythm — grafic sinusoidal al celor trei cicluri: fizic (23 de zile), emoțional (28), intelectual (33).

Calculul este aici, doar render; pentru bi-roată toate planetele celor două hărți sunt calculate în paralel (Promise.all).

2026-02-24 — Vizualizare: renderare SVG (+4 endpoint-uri)

Patru noi endpoint-uri care returnează renderări SVG ale hărților natale și a unor vizuale asociate. Pur server-side — fără Puppeteer/headless-Chrome, deci întârziere ~10 ms în loc de 1-2 secunde și gratuit pentru planul gratuit.

• POST /v1/render/wheel-western — roată occidentală (inel de semne + inel de case + planete + linii de aspect).
• POST /v1/render/aspect-grid — matrice triunghiulară de aspecte cu semn + orb în celule.
• POST /v1/render/moon-phase — discul Lunii cu iluminare; returnează SVG plus illuminationFraction, phase, waxing.
• POST /v1/render/timeline — stil Gantt pentru evenimente-tranzit pe o perioadă (apelantul furnizează un array events).

Opțiuni: size, theme (light / dark / console), format (json returnează { svg, byteLength }, svg returnează image/svg+xml direct). Nivel de bază — 2 credite pe apel.

2026-02-23 — Tipuri de scheme în /v1/openapi.json (612 endpoint-uri, 98%)

/v1/openapi.json este acum o specificație completă și citită de mașină și pentru corpuri de cerere, și pentru date de răspuns. Tipizate 612 din 624 de endpoint-uri POST prin trei etape consecutive care au aterizat împreună:

• Corpuri de cerere — 386 de endpoint-uri tipizate prin components.schemas (128 de componente reutilizabile). Printre acestea se numără 5 comune (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) și 123 locale (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern etc.). Compoziție prin allOf pentru moștenire (DashaInput extends ChartInput).
• Date de răspuns — 612 endpoint-uri tipizate prin inferator care parcurge exemplele de răspuns din manifest: {type: 'object', properties: {...}} în loc de {type: 'object'} plat. Harta natală declară acum data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] cu tipuri reale de câmpuri.
• Restul de 12 endpoint-uri — dasha pratyantar/sookshma cu exemple de prescurtare neclare în manifest — rămân {type: object}. Compatibilitate inversă, adăugăm-le în lansări ulterioare.

Ce este acest lucru pentru integrator:

• Regenerați clientul OpenAPI — openapi-typescript, openapi-fetch, swagger-codegen vor crea interfețe cu câmpuri tipizate în loc de Record<string, unknown>. Autocompletare pe corpuri de cerere + date de răspuns funcționează nativ.
• Colecția Postman pe /postman/astroway-api.json a fost actualizată cu aceleași tipuri — importați, obțineți autocompletare pentru toate endpoint-urile tipizate.

Compatibilitate inversă: forma anterioară { "type": "object" } a fost permisivă — toți clienții existenți continuă să funcționeze fără modificări.

2026-02-21 — Recalcularea prețurilor: Rapoarte unificate, Business +500K, Free consolidat

Trei schimbări de prețuri care afectează integratorii:

• Rapoarte unificate la 5.000 de credite — /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitab au fost reduse de la 10.000 la 5.000 de credite pe apel (cu 50% mai ieftin). Toate rapoartele PDF au acum același preț — matematică mai simplă pentru bugetul pachetului.
• Planul Business +500K de credite/lună — tariful Business oferă acum 3.500.000 de credite pe lună (față de 3.000.000 anterior) la același preț de 199 $. Abonații existenți vor primi limita crescută automat cu următorul ciclu de facturare.
• Planul Free: /v1/reports/* necesită un plan plătit — 12 endpoint-uri PDF (reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) returnează acum 402 PLAN_UPGRADE_REQUIRED pentru chei Free. Restul funcționalității — hărți, sinastrie, prognoze, horoscop — rămâne disponibilă pe Free.

Dacă cheia dvs. Free a apelat vreunul dintre aceste endpoint-uri — actualizați-vă la Indie (5 $/lună) sau mai sus, sau comutați la echivalenții JSON (/v1/chart, /v1/synastry etc.) pentru conținut similar fără render PDF.

2026-02-19 — Autentificare prin Google și GitHub (+2 endpoint-uri)

Un singur cont pentru toată ecosistema — utilizatorul care s-a înregistrat pe astroway.info sau app.astroway.info se autentifică în consola de dezvoltator prin aceeași adresă de e-mail/SSO, vede istoricul comenzilor, creditele și cheile API.

• GET /v1/auth/oauth/google/start?return=<path> — inițiază fluxul de autentificare Google OAuth.
• GET /v1/auth/oauth/github/start?return=<path> — inițiază fluxul de autentificare GitHub OAuth.

Callback-ul se finalizează prin redirectarea către /dashboard/oauth/callback#access_token=&refresh_token=&user= — apoi dashboard-ul persistă tokenurile ca și în cazul /v1/auth/login. Dacă adresa de e-mail este deja înregistrată prin formularul obișnuit și email_verified=true de la furnizor — contul este legat, nu se creează unul nou.

2026-02-17 — Pachet de rapoarte ($99 / 500.000 de credite) + white-label inclus

Tarif pentru dezvoltatorii de rapoarte PDF — 100 de rapoarte PDF/lună la 0,99 $ efectiv, cu white-label implicit:

• Tariful reports_pack (99 $/lună sau 990 $/an) oferă 500.000 de credite și 200 de cereri/oră.
• Acces limitat la /reports/* (12 tipuri de rapoarte PDF: natal, sinastrie, copil, afaceri, carieră, dragoste, bani, tranzit-anual, kundli vedic, lal-kitab, design uman, tarot) + /whitelabel/* (logo personalizat + culori + domeniu). Toate celelalte endpoint-uri returnează 402 PLAN_PACK_MISMATCH.
• White-label inclus ca standard — nu este necesară actualizarea la Enterprise pentru PDF-uri personalizate cu brand.
• Suprataxă de 3 $ / 10.000 de credite (ca și la Pro), comutator de limitare a cheltuielilor disponibil.
• 21 de localizări pentru rapoarte PDF, format A4, livrare prin URL semnat CDN (TTL 24 de ore).

API plan enum acum: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack. Noul slug WC: astroway-api-reports-pack.

2026-02-15 — Yogă Jaimini + Lal Kitab și KP dosha (+17 endpoint-uri)

17 endpoint-uri — închid categoria de yogă și dosha a școlii nord-indiene vedice.

• Yogă Jaimini (5) — /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Bazate pe chara karakas (AK / Amk / PK).
• Variante de dosha Lal Kitab (6) — /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. Variante specifice Lal Kitab și upayas.
• Variante de dosha KP (6) — /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. Reguli BPHS + lanț de sub-stăpâni KP. Sade Sati — conștient de tranzit (necesită targetDate).

Surse: Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI.

2026-02-13 — Pachet Vedic ($19 / 100.000 de credite)

Tarif separat pentru astrologia vedică — 165 de endpoint-uri la prețul Starter:

• Tariful vedic_pack (19 $/lună sau 190 $/an) oferă 100.000 de credite și 100 de cereri/oră.
• Acces limitat la namespace-urile Vedic (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Toate celelalte endpoint-uri returnează 402 PLAN_PACK_MISMATCH.
• Acoperire: 16 varga D1-D60, panchang (7), shadbala (7), yogă (7), dosha (7), compatibilitate ashtakoot (6), muhurat (12 categorii), 8 sisteme de dasha × 5 niveluri (40), KP, Lal Kitab, Jaimini.
• 2,5-5 × mai multe hărți pentru același preț ca Prokerala Ruby (~5.000 de kundli/lună față de 1-2.000 ale lor).

API plan enum acum: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. Noul slug WC: astroway-api-vedic-pack.

2026-02-09 — Lal Kitab: pachet complet (+12 endpoint-uri)

Douăsprezece endpoint-uri ale școlii nord-indiene vedice pe baza manuscriselor anonime Urdu 1939-1952. Întreaga școală — YELLOW (intrinsic — single-school cu divergențe între autori moderni).

• /vedic/lal-kitab/teva — hartă cu case fixe (casă = semn).
• /vedic/lal-kitab/lal-kundali — layout de grid 12 case.
• /vedic/lal-kitab/kismat + /prosperity — scoruri de noroc și yogă de avere.
• /vedic/lal-kitab/dasha (35 de ani) + /varshphal + /life-graph — temporizare.
• /vedic/lal-kitab/debts — detectare a celor 6 Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) + remediu.
• /vedic/lal-kitab/remedies — upayas pe planetă (zi / mantra / donație).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

Disclaimer afișat în răspunsuri. Surse: K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Pachet Esoteric ($9 / 200.000 de credite)

Noul pachet suplimentar pentru dezvoltatorii de ezoterism/divinație — 180 de endpoint-uri la 9 $/lună:

• Tariful esoteric_pack (9 $/lună sau 90 $/an) oferă 200.000 de credite și 60 de cereri/oră.
• Acces limitat la spațiile esoteric/divinație (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Toate celelalte endpoint-uri returnează 402 PLAN_PACK_MISMATCH.
• Nu se combină cu alte tarife pe aceeași cheie — această extensie este separată, similar cu Pachetul HD.

API plan enum acum: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. Noul slug WC: astroway-api-esoteric-pack (variații lunare și anuale). Dacă ați creat chei prin /v1/keys fără plan explicit — nimic nu se schimbă.

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

A treia categorie chineză, după Zodiacul chinez și Feng Shui:

• BaZi (5) — /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. Stâlpi de an și lună canonici, stâlpii de zi și oră amânate până la verificarea transversală cu Observatorul din Hong Kong (surse diferite oferă ancore JD diferite).
• 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 — semnificații ale palatelor + lista celor 14 stele principale. Harta completă amânată (necesită ephemeris lunară specializată).

API-ul expune acum 505 de endpoint-uri — paritate cu competitorul mai larg (Astrology-API.io).

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

Nouă endpoint-uri de wellness — astrologie medicală + dietă + yoga + cristale etc. Utilizare educațională numai — nu sfaturi medicale, disclaimer în fiecare răspuns.

• POST /v1/wellness/medical-astrology — guvernarea corpului după Melothesia tradițională.
• POST /v1/wellness/diet — alimente după element (focalizare / accentuare / evitare).
• POST /v1/wellness/yoga — focalizare + asane + pranayama după semn.
• POST /v1/wellness/exercise — intensitate + recomandări după element.
• POST /v1/wellness/mental-health — profil de elemente + dominantElement + puncte forte / slabe + mecanisme de coping.
• POST /v1/wellness/sleep-cycles — sfaturi de somn după fazele Lunii.
• POST /v1/wellness/herbs — plante după guvernarea planetară a semnului (Culpeper 1653).
• POST /v1/wellness/crystals — cristale după semn + intenții.
• POST /v1/wellness/cycle — repere de wellness legate de vârstă (Saturn return, Uranus opposition, …).

Surse: Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Nivel — 2 credite (ciclu = 1 credit).

2026-01-27 — Calendare Maya (+8 endpoint-uri)

Blocul Maya: calendarul sacru Tzolkin + Haab + Long Count + Calendar Round + Lord of the Night, plus Dreamspell (modern Argüelles 1990).

• POST /v1/mayan/tzolkin — calendarul de 260 de zile sacru (număr 1-13 + nume din 20).
• POST /v1/mayan/haab — calendarul civil de 365 de zile (18 luni × 20 + 5 zile Wayeb).
• POST /v1/mayan/long-count — notație pozițională de 5 locuri baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round — calendar combinat Tzolkin+Haab (ciclu de 52 de ani).
• POST /v1/mayan/lord-of-night — ciclu de 9 zile (G1-G9).
• POST /v1/mayan/full — totul clasic într-un singur apel.
• POST /v1/mayan/compatibility — compatibilitatea perechii după ton / nume / element / direcție.
• POST /v1/mayan/dreamspell — modern Argüelles (kin 1-260, ton × siglă).

Sursă: corelația Goodman-Martínez-Thompson (Thompson 1935 + Lounsbury 1976). Validare ancoră: 2012-12-21 = Long Count 13.0.0.0.0 ✓ (rollover Bak’tun).

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

Două școli Jaimini de rasi-dasha cu cascade completă:

• Sthira — ciclu de 40 de ani, 12 semne (7 ani pentru semne mobile / 8 ani pentru semne fixe / 9 ani pentru semne duale).
• Shoola — ciclu de 100 de ani, 7 planete (fără umbre).

Surse: BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

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

Trei categorii într-un singur transport:

• 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: divertisment numai — nu îngrijire veterinară.
• 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: idei strategice, nu consultanță juridică / fiscală.
• Financial (10) — /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}. ⚠️ NU SFATURI DE INVESTIȚII — disclaimer întărit în fiecare răspuns.

Nivel — 2 credite (Financial market-timing/wealth-cycle = 3 credite).

2026-01-16 — Analiză Jaimini (+10 endpoint-uri)

Zece endpoint-uri analitice Jaimini — chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK în D9), rezumat de dasha în curs, yogă Jaimini de bază.

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

2026-01-09 — Status page + agenți AI + URL de bază implicit

• Pagină publică de stare: https://api.astroway.info/status — timp de funcționare, latență p50/p95/p99, cache 60s.
• llms.txt pentru agenți AI: https://api.astroway.info/llms.txt — instrucțiuni structurate pentru agenți Claude / ChatGPT / Perplexity Code.
• URL de bază implicit în documentație, server MCP, SDK-uri, colecție Postman — api.astroway.info/v1 (cu redirect 301 de la vechiul api-calc.astroway.info).

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

Trei sisteme de dasha nakshatra cu cascade completă:

• Tribhagi — scară 1/3 Vimshottari (ciclu de 40 de ani).
• Shatabdika — ciclu de 100 de ani, 7 planete (fără umbre).
• Shodashottari — ciclu de 116 ani, 8 planete (fără Rahu).

Surse: BPHS Adhyaya 46.

2025-12-25 — Compatibilitate Vedică + Muhurat (+18 endpoint-uri)

• Compatibilitate (6) — potrivire Ashta-Koota (Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi) + compatibilitate Mangal dosha + rezumat Bhrigu.
• Muhurat (12) — alegere pentru căsătorie, afaceri, călătorie, educație, chirurgie, logodnă, tipuri de muhurat.

Surse: BPHS + Muhurta Chintamani.

2025-12-02 — KP (Krishnamurti Paddhati): pachet complet (+10 endpoint-uri)

Zece endpoint-uri ale școlii KP canonice (K.S. Krishnamurti 1971).

• /vedic/kp/{cusps, sub-lords, planet-cuspal-position} — cusps Placidus + lanț de 4 niveluri de sub-stăpâni (semn / stea / sub / sub-sub).
• /vedic/kp/ruling-planets — planete care guvernează zi / oră / asc / lună, deduplicate.
• /vedic/kp/horary — număr de întrebare KP 1..249 → căutare longitudine ASC.
• /vedic/kp/significators — primar / secundar / terțiar pe planetă.
• /vedic/kp/sub-sub-lord — lanț la longitudine sidereală arbitrară.
• /vedic/kp/asc-sub — sub-stăpân al Ascendentului.
• /vedic/kp/fortuna — Partea de Noroc (zi/noapte) + lanț KP.
• /vedic/kp/transit-kp — poziții actuale + lanț KP.

Algoritm: diviziuni proportionale Vimshottari (27 de stele × 9 sub-stăpâni). Surse: K.S. Krishnamurti Reader I-VI (1971-77).

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

Patru sisteme clasice de dasha vedice cu cascade completă (maha, antar, pratyantar, sookshma, prana):

• Vimshottari — ciclu de 120 de ani, 9 planete.
• Yogini — ciclu de 36 de ani, 8 yogini.
• Ashtottari — ciclu de 108 ani, 8 planete (fără Ketu), tradiția Ardradi.
• Kalachakra — dasha bazată pe semne, paramayu variază pe pada (100/85/83/86).

Surse: BPHS Adhyaya 46 + Saravali. Validat împotriva PyJHora 7.02.

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

Școala Jaimini de rasi-dasha în varianta K.N. Rao (1995). Direcția = înainte pentru semne mobile / duale ale lagnei, invers — pentru semne fixe. Regula co-stăpânirii pentru Scorpion (Marte + Ketu) și Vărsător (Saturn + Rahu).

2025-10-25 — Server de sinastrie + compus

Astrologia relațională (sinastrie, compus, Davison) implementată pe server. Prin /v1/synastry, /v1/composite, /v1/davison. Marcator de extindere la analiză relațională.

Validat împotriva Solar Fire / Astrodienst — drift în limitele erorii metodei (≤0,5″ pe calculul mediu).

2025-09-29 — Sinastrie, compus, Davison + sinastrie de grup (+5 endpoint-uri)

• /synastry — comparație de relație cu matrice de aspecte.
• /composite — compusul punctului de mijloc Robert Hand.
• /davison — compusul timp-loc Ronald Davison.
• /group-synastry — matrice de sinastrie multi-persoană (3+).

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

2025-08-10 — Dicționare ezoterice + Cristal / Înger / Vis (+30 endpoint-uri)

Extinderea dicționarelor de referință: 15 concepte ezoterice (chakre, koșa, tattva, guna) + 15 tabele de căutare cristal / înger / vis. Cache pe margine (Cloudflare R2).

2025-07-18 — Dicționar de referință + Tarot Lenormand (+24 endpoint-uri)

• Referință (14) — dicționare de semne, planete, case, aspecte, nakshatra, stele fixe, simboluri Sabian.
• Tarot Lenormand (10) — sistemul de 36 de cărți: singură, 3 cărți, 9 cărți, Grand Tableau, pe întrebare.

2025-05-20 — Tarot Marseille (+20 endpoint-uri)

20 de endpoint-uri pentru pachetul Marseille: răspândiri (singură, 3 cărți, Cruce, 5 cărți, Celtic Cross, an înainte), înțelesuri de cărți, mod inversat, pe întrebare. Surse: referințe publice Camoin / Jodorowsky.

2025-03-15 — Numerologie — pachet complet: Pitagoric + Caldeean + Kabalistic + Vedic (+40 endpoint-uri)

Patru sisteme numerologice × 10 endpoint-uri fiecare: calea vieții, expresie, impuls sufletesc, personalitate, ziua nașterii, maturitate, an / lună / zi personală curentă, compatibilitate de nume.

Surse: Pitagoric (Cheiro 1908), Caldeean (Cheiro), Kabalistic ebraic gematria, Vedic Caldeean Indian.

2025-02-20 — Tarot Rider-Waite-Smith (+35 endpoint-uri)

35 de endpoint-uri pentru pachetul RWS: toate răspândirile canonice (singură, 3 cărți, Celtic Cross, an înainte, relație, 5 cărți în formă de potcoavă, 7 cărți în formă de elipsă, decizie, situație, lunar), înțelesuri de cărți (drept / invers), pe întrebare, carte zilnică, amestecare de pachet.

Surse: Imagini PD Smith din 2021, Waite “Pictorial Key” 1909 PD.

2025-01-27 — Generare de horoscop AI + interpretări (+12 endpoint-uri)

Generare de texte de interpretare:

• /horoscope/{daily, weekly, monthly} — texte de horoscop.
• /interpret/{natal, transit, synastry, compatibility} — interpretări detaliate.

Lanț de furnizori: GPT-4 → Anthropic Claude → fallback Groq.

2024-12-18 — Matricea Destinului (Ladini) (+1 endpoint)

/destiny-matrix/ladini — sistemul Natalia Ladini (piața rusă / CIS). Metodă cu un singur autor cu disclaimer explicit.

2024-11-20 — Cronogramă de aspecte + armonici + indice ciclic (+12 endpoint-uri)

Analiză de aspecte extinsă:

• /aspect-timeline — momente exacte de aspecte pe N zile înainte.
• /harmonics/{2..12} — hărți armonice.
• /cyclic-index — indice ciclic de tensiuni sociale al lui André Barbo.
• /sabian-symbols — 360 de simboluri ale lui Marc Edmund Jones.

2024-10-15 — Astrocartografie + Spațiu Local + Geodetic (+18 endpoint-uri)

Geo-astrologie:

• /acg + /acg-zones — linii planetare Astrocartografie.
• /local-space — orizontul Spațiului Local.
• /parans — parane (Bernadette Brady).
• /relocation — hartă de relocare.
• /zenith + /horizon + /geodetic — motoare geo-suplimentare.
• /ccg-analysis — analiză CCG/CMG detaliată.

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

2024-09-20 — Modul de Design Uman (+12 endpoint-uri)

Motor de Design Uman complet:

• /human-design — corpograf (porți, canale, centre, tip, profil, autoritate, strategie, mediu, perspectivă).
• /hd/incarnation-cross — crucea de întrupare + 4 porți.
• /hd/{channels, gates, profiles, definition, authority, strategy, environment, perspective, mental-projector, etc}.

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

2024-08-25 — Server de sinastrie + compus + Davison

Astrologia relațională (sinastrie, compus, Davison) implementată pe server. Prin /v1/synastry, /v1/composite, /v1/davison. Marcator de extindere la analiză relațională.

Validat împotriva Solar Fire / Astrodienst — drift în limitele erorii metodei (≤0,5″ pe calculul mediu).

2024-07-28 — Sinastrie, compus, Davison + sinastrie de grup (+5 endpoint-uri)

• /synastry — comparație de relație cu matrice de aspecte.
• /composite — compusul punctului de mijloc Robert Hand.
• /davison — compusul timp-loc Ronald Davison.
• /group-synastry — matrice de sinastrie multi-persoană (3+).

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

2024-06-15 — Endpoint-uri de referință: publice, fără cheie, fără credite

14 endpoint-uri /v1/reference/* (semne, planete, case, aspecte, nakshatra, stele fixe, simboluri Sabian) funcționează acum fără X-Api-Key și costă 0 credite. Acestea sunt tabele de căutare canonice — a le factura prin facturare a fost o supraveghere a proiectului.

Ce este acest lucru pentru integrator:

• Apel fără cheie — agenți externi MCP / SDK / pagini de previzualizare pot trage date de referință fără autentificare. Limitarea rate-ului IP (30 de cereri / oră) rămâne.
• Manifest de cost actualizat — 14 căi trec de la TIER_HALF (5 credite) la 0. Dacă planul dvs. de bugetare astroway_cost_estimate se referă la aceste căi — noile apeluri nu afectează cota.
• Clienți existenți cu cheie funcționează fără modificări. X-Api-Key este ignorat pentru /reference/* (nu suntem atenți la antetul suplimentar).

Compatibilitate inversă: răspunsurile 200 și schema JSON nu se schimbă, doar cerința de autentificare este eliminată.

2024-06-10 — Trecere la Swiss Ephemeris 2.10

Biblioteca Swiss Ephemeris 2.10 integrată în backend astroway.info. Precizie sub-arcsecundă a pozițiilor planetare, a nodurilor lunare, a asteroidelor în intervalul 1900–2100.

Toate endpoint-urile de calcul următoare se bazează pe acest strat. Aceeași bibliotecă folosită în Solar Fire, Kepler, Astro Gold, Astrodienst.