Changelog what is new

Minden olyan változás, amely az integrátor kódját érinti: új végpontok, SDK-frissítések, /openapi.json módosítások, árak módosítása hitelben, elavultság, töri változások. A legfrissebb van felül. A weboldal belső változásai itt nincsenek rögzítve.

Az API-szerződés stabil a /v1/* határain belül – minden töri változás a /v2/* alatt jelenik meg, és a /v1/* legalább 12 hónapig továbbra is működik.

2026-05-16 — A hosztolt MCP végpont elérhető a mcp.astroway.info/mcp címen

A @astroway/mcp most már két szállítási módban érhető el. A Stdio (npm-csomag) változat változatlan marad; hozzáadva a hosztolt Streamable HTTP végpont a zero-install integrációhoz a Claude $1 (claude.ai böngészőben), Claude $1, Cursor, Cline és más MCP-kompatibilis kliensek számára.

Egykattintásos telepítés a Cursorhoz – a cursor://anysphere.cursor-deeplink/mcp/install?... gomb az /examples/mcp/ oldalon. A Claude $1 a + → Add Connector → Custom segítségével telepíthető (JSON szerkesztése nélkül).

// JSON változat Cline / Continue / Windsurf számára
{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Ugyanaz a 630 eszközből álló katalógus + 12 prompt + 14 erőforrás, ugyanaz az aw_test_* / aw_live_* hitelesítés (hosztolt módban Authorization: Bearer … fejlécben a környezeti változó helyett), ugyanaz a hitelkészlet. Multi-tenant tervezés szerint – minden kérés hordozza a saját kulcsát, a hitelek a kulcs tulajdonosának fiókjáról kerülnek levonásra. A csatorna a X-Astroway-Channel fejlécben – mcp-http (hosztolt) vs mcp (stdio) az adoptálás nyomon követéséhez.

Miért két mód. A Stdio (npx @astroway/mcp) változat a Cursor power user-ek / adatvédelmi szempontból érzékeny integrátorok számára marad – a kulcs soha nem hagyja el a gépet, nincs hálózati ugrás. A hosztolt mód lefedi a Claude $1 szegmensét (amely csak távoli MCP-t támogat) és a zero-install forgatókönyveket. Ugyanaz a minta, mint a Stripe / Resend / GitHub MCP esetében.

Health végpont – nyilvánosan elérhető hitelesítés nélkül:

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

A két mód teljes dokumentációja – /examples/mcp/.

2026-05-15 — Új végpont GET /v1/auth/keys/me

API-kulcs introspekció. Adja meg az X-Api-Key-t – kapja meg a teljes állapotot: terv, hitelek, státusz, hozzárendelt domain, létrehozás ideje, regisztráció forrása. Hasznos az SDK-felhasználók számára (TS / Python / PHP / MCP) – “milyen kulcsom van most” anélkül, hogy a dashboardot olvasná. Hasonló a Stripe /v1/account vagy GitHub /user végpontokhoz.

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # első 11 karakter, a teljes kulcsot soha nem adja vissza
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # naptári hónap vége
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # domain, amelyhez a kulcs kötve van (wp-plugin kulcsok)
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

Nincs hitelesítés: 401 MISSING_API_KEY. Érvénytelen kulcs: 401 INVALID_API_KEY.

OpenAPI 3.1 spec. A /v1/openapi.json most már deklarálja a /v1/auth/keys/me végpontot. Az SDK kódgenerátor a következő újrageneráláskor hozzáadja a client.auth.keys.me() metódust.

Visszafelé kompatibilitás. A régi GET /v1/keys/usage (csak credits_today + ratelimit visszaadása) továbbra is működik – ez egy külön végpont a szerver oldali cron-ellenőrzésekhez. A /auth/keys/me visszaadja a teljes állapotot plusz a domain kötést a wp-plugin forgatókönyvekhez.

2026-05-14 — Lokalizáció /horoscope/* és /interpret/* (21 nyelv)

POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility} és POST /v1/interpret/{natal,synastry,transits,element,placement} – 10 végpont, amely szöveges értelmezést ad vissza – mostantól a kliens nyelvén adja vissza a választ.

Hogyan kapcsolja be:

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"}'
# → válasz हिन्दी nyelven

Resolve-prioritás (szerver oldalon):

1. body.language="de" – explicit per-call paraméter (legmagasabb prioritás)
2. Accept-Language: de, en;q=0.7 – RFC 7231 q-weighted; az első kód, amely megegyezik az aktív nyelvvel, nyer
3. ?lang=de – query-paraméter azok számára, akik nem ellenőrzik a fejléceket
4. Fallback → uk (forrásnyelv)

Támogatott nyelvek (21): uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id. Ismeretlen kódok csendesen uk-ra esnek vissza hiba nélkül.

OpenAPI 3.1 spec. A /v1/openapi.json most már deklarálja az Accept-Language (fejléc) és lang (query) paramétereket 21 kódos enummal ezen a 10 végponton. Az SDK kódgenerátor (openapi-typescript, openapi-generator-cli) automatikusan hozzáadja a típusos hívásokat .lang('hi') a következő újrageneráláskor.

Mi kerül lefordításra: csak a szöveges mezők értelmezése (horoscope, interpretation, disclaimer stb.). A numerikus mezők (longitude, latitude, score, ID-jelek, ID-házak) kanonikusak maradnak – a kliens helyileg formázza őket. Szegmens szabvány (Vedika, DivineAPI, AstrologyAPI.com).

Hatály: jelenleg csak a 10 értelmezési csoport végpontot lokalizálják. A számítási végpontok (/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690 másik) számokat és kanonikus azonosítókat adnak vissza (name: "Aries", glyph: "♈") változatlanul – a kliens a saját lookup-táblái segítségével lokalizálja őket. Ez a szegmens szabvány.

Visszafelé kompatibilis. A meglévő kód, amely nem használ Accept-Language / ?lang= / body.language, továbbra is uk-t kap alapértelmezetten, ahogy korábban is.

Az SDK-támogatás (@astroway/sdk, astroway, astroway/sdk, @astroway/mcp) hozzáadja a lang opciót a konstruktorhoz – külön kiadások érkeznek a következő hetekben a staging-repókban lévő cron-applier segítségével.

2026-05-09 — Három SDK indult: TypeScript, Python, PHP

Három hivatalos SDK él a nyilvános regisztrációkon – burkolók ugyanazok körül a 700+ API-végpont körül. Egy OpenAPI 3.1 spec → három nyelvhez illő kliens.

Mit jelent ez az integrátornak:

• Type-safe alternatíva a nyers HTTP-hez. Útvonal kiegészítés + kérés és válasz típusok az IDE-ben. Helper-módszerek aw.post('/chart', body=...) (Python/PHP) vagy aw.client.POST('/chart', { body }) (TS) – manuális fetch / requests / Guzzle helyett.
• Azonos felület minden nyelven. A konstruktor Astroway({apiKey, baseUrl, authScheme, timeout, retry}) ugyanúgy működik TS / Python / PHP-ben. Ha a projekt több nyelvű – kevesebb kognitív terhelés.
• Beépített újrapróbálkozás 408/409/429/5xx hibák esetén exponenciális visszatartással + teljes jitterrel. Tiszteletben tartja a Retry-After fejlécet. Alapértelmezett 2 újrapróbálkozás, konfigurálható retry={maxRetries: 0} segítségével.
• Stainless-sablonú hibajerarhia – ugyanaz a minta, mint a Stripe / OpenAI / Cloudflare SDK-kban. Fogja el a RateLimitError (a retryAfterSeconds-sel), AuthenticationError (kulcs cseréje), BadRequestError (validáció), ApiError (általános) – ebben a sorrendben.
• Két hitelesítési séma. Alapértelmezés szerint X-Api-Key: aw_live_... (mint a curl/Postman). Vagy Authorization: Bearer aw_live_... (mint a Stripe/OpenAI/Anthropic SDK) – auth_scheme="bearer" a konstruktorban.
• Azonosító fejlécek, nincs telemetria. Minden kérés tartalmazza a User-Agent: astroway-sdk-<lang>/<version> és X-Astroway-Channel: sdk-<lang> fejléceket. Semmilyen telefonhívás, semmilyen engedélyezési/tiltás kapcsoló.
• OIDC + SLSA L3 eredetbizonyíték (TS + Python). Sigstore-igazolt rekord, amely szerint a csomag egy adott commitból készült a nyilvános repo-ból. Nincs hosszú élettartamú token a CI-ben.
• MIT, teljes forráskód nyílt a github.com/astroway/{astroway-typescript,astroway-python,astroway-php} címen.

Gyors indítás:

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

Aszinkron változat Pythonhoz – AsyncAstroway azonos felülettel async/await segítségével. PHP-ben – csak szinkron (a PHP-nak nincs egységes aszinkron története). TS-ben – natív promise a openapi-fetch alapján.

Ez egy alfa – a nyilvános API változhat a 0.1.0-ig a visszajelzések alapján. Rögzítse a pontos verziót (@astroway/sdk@0.1.0-alpha.1) az alfa időszak alatt – vagy a legújabb alfa a telepítés pillanatában.

A @astroway/mcp – MCP-szerver a Claude / Cursor / GPT számára – továbbra is mellette él külön termékként.

2026-05-07 — MCP szerver frissítés

A @astroway/mcp frissült – automatikusan generálja az eszközkatalógust a jelenlegi /openapi.json-ből manuális szerkesztés nélkül. Minden, ami az API-ban az elmúlt hetekben megjelent (kompatibilitási csomag, jelentések végpontok), azonnal látható a Claude / Cursor / GPT számára.

Az integrátornak:

• Az eszközkatalógus tükrözi az API élő állapotát
• A Path-template végpontok (/v1/.../id) jelenleg kihagyásra kerülnek, hogy ne zavarják a leírás-elemzőt
• A költségannotációk a leírásban – a Claude látja a hívás költségét a végrehajtás előtt
• OIDC trusted publishing + SLSA L3 eredetbizonyíték – a csomag igazolt egy adott commitra a nyilvános repo astroway/astroway-mcp-ben

Telepítés:

npm install -g @astroway/mcp

Vagy a Claude $1 / Cursor MCP konfiguráció segítségével:

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

Forrás: nyilvános astroway/astroway-mcp (MIT).

2026-04-11 — Keresztrendszer kompatibilitás (+10 végpont)

Új /v1/compat/* csoport – összetett kompatibilitási pontszám a nyugati, vedikus, kínai, numerológiai, tarot, emberi tervezés rendszerek között. 6 rendszer ad egy egységes metrikát UX-indikátorokhoz többhagyományú asztrológiai alkalmazásokban.

Minden végpont JSON-t ad vissza disclaimer mezővel – ez az AstroWay pontozási módszertana, nem klinikai vagy jogi állítás. Tier 4 (100 hitel) hívásonként – nehéz keresztrendszer számítás.

A manifest a /openapi.json-ben frissült – az SDK / MCP automatikusan felveszi.

2026-03-28 — Jelentések + Webhookok (+17 végpont)

Két új csoport élesben.

/v1/reports/* (12 végpont) – HTML / PDF jelentések generálása Puppeteerrel. Render az api-calc oldalon, aláírt letöltési URL (TTL 24h).

/v1/webhooks/* (5 végpont) – előfizetés-kezelés, események kézbesítése, HMAC aláírás. Előfizetés az eseményekre 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_..."}'

Minden kézbesítés tartalmazza a X-Astroway-Signature: sha256=<hmac> fejlécet – ellenőrizze a secret segítségével. Újrapróbálkozási szabályzat: exponenciális visszatartás 5xx hibák esetén, legfeljebb 5 próbálkozás 24 órán belül.

2026-03-14 — Referencia végpontok: nyilvános, kulcs nélkül, hitel nélkül

14 végpont /v1/reference/* (jelek, bolygók, házak, aspektusok, elemek, modalitások, polaritások, méltóságok, decanok, nakshatrak, lotok, aszteroidák, zodiákus-rendszerek, glifok) mostantól működik X-Api-Key nélkül és 0 hitelbe kerül. Ezek kanonikus lookup-táblák – a számlázással való blokkolásuk projekttervezési hiba volt.

Mit jelent ez az integrátornak:

• Hívás kulcs nélkül – külső MCP-ügynökök / SDK-k / előnézeti oldalak lehívhatják a referenciaadatokat hitelesítés nélkül. Az IP sebességkorlát továbbra is érvényes, mint a /public (30 kérés/óra).
• Költségmanifest frissült – 14 útvonal váltott TIER_HALF (5 hitel) helyett 0-ra. Ha a költségvetési terv astroway_cost_estimate hivatkozik ezekre az útvonalakra – az új hívások nem érintik a kvótát.
• Meglévő kliensek kulccsal változatlanul működnek. Az X-Api-Key figyelmen kívül hagyásra kerül a /reference/* esetében (nem foglalkozunk a felesleges fejléccel).

Visszafelé kompatibilis: a 200 válaszok és a JSON-séma nem változik, csak a hitelesítési követelmény került eltávolításra.

2026-03-07 — Alapítói Életre Szóló Kedvezmény: $299 → Indie terv életre szólóan

Elindítjuk az Alapítói Életre Szóló Kedvezményt – korlátozott indítás. Az első 100 ügyfél fizet egyszeri $299-et és megkapja az Indie tervet (50 000 hitel/hó) örökre, rekurzív levonások nélkül, rögzített áron.

Mit jelent ez az integrátornak:

• Szabványos Indie = $5/hó. Alapítói = egyszeri $299 → megtérülési pont az 5. évben, utána végtelen ROI. Ha a projekt legalább 5 évig aktív az asztrológiában / numerológiában / Tarotban – az Alapítói megéri.
• Webhook payload a checkout SKU astroway-api-indie-lifetime esetén: az api_keys sor kap plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. Nincs havi levonás, nincs újraaktiválási webhook.
• Adatbázisséma: hozzáadva az is_lifetime TINYINT(1) oszlop az api_keys és shared_user_quotas táblákhoz. A TS-típus ApiKeyInfo kibővült. A meglévő kulcsok = is_lifetime=0 (a viselkedés változatlan).
• WP REST végpont GET /wp-json/astroway/v1/founders-count visszaadja {sold, total: 100, remaining, available} – a site/components/founders/FoundersCounter.astro komponens valós idejű számlálóként használja a /founders/ oldalon.
• Automatikus deaktiválás 100/100 esetén: a WC termék _stock_status automatikusan outofstock-ra vált a WC woocommerce_order_status_completed hook segítségével. Ezt követően a checkout link átirányít a /pricing/#indie-re (szabványos Indie $5/hó).

Élő oldalak: /founders/ (uk) + /en/founders/ (en). Oldalsáv bejegyzés “Alapítói Életre Szóló Kedvezmény” 🚀 100 only jelzéssel.

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

2026-03-05 — GDPR / EU lakhely oldal + Pro kártya EU jelzése

Elindítjuk a /eu/ – külön oldal az EU-fejlesztők számára, akiknek a terméke GDPR-érzékeny. Az integrátornak fontos tudnia:

• Pro $59 = EU-lakhely alapértelmezés szerint (Hetzner Nürnberg, adatfolyam csak az EU-n belül, anonimizált analitika – a Plausible cookie-free a roadmapon).
• Szabványos DPA nem csak az Enterprise számára érhető el – emailben aláírható a szabványos Pro terven 5 munkanapon belül.
• DELETE /v1/me/account – végpont a GDPR törlési jogához (azonnal törli a wp_user_id-t minden táblából).
• A Pro kártya a /pricing/-on most már 🇪🇺 GDPR-kész jelzéssel rendelkezik – a kattintás a /eu/-ra visz teljes FAQ-kal.
• DivineAPI / AstrologyAPI / Prokerala – US/India szerver, DPA csak Enterprise számára. Ha a GDPR megfelelés kritikus – a Pro $59 a legolcsóbb út.

Oldalak: /eu/ (uk) + /en/eu/ (en). Bejegyzés az oldalsó navigációban «GDPR / EU lakhely» 🇪🇺 jelzéssel.

2026-03-03 — Éves előfizetés −25% + hitelátvitel + nyilvános Pro funkciók

Két változás, amely az integrátor kódját érinti:

• Éves kedvezmény 17% → 25% (3 hónap ingyen 2 helyett). Új USD árak évente: Indie $45, Starter $171, Pro $531, Business $1791, HD/Esoteric Pack $81, Vedic Pack $171, Reports Pack $891. A meglévő éves előfizetők nem érintettek – az új ár csak a jövőbeli előfizetési megújításokra vonatkozik. Ha az USD árakat a /wp-json/astroway/v1/api-prices segítségével elemzi – az új értékek mostantól automatikusan visszaadódnak.
• Hitelátvitel az éves előfizetők számára: a fel nem használt hitelek átmennek a következő havi ciklusra, a terv havi korlátjának 1-szeresével korlátozva. Automatikusan aktiválódik az éves terv megvásárlásakor. Látható az új válaszfejlécekkel:
  • X-Credits-Limit: <int> – hatékony havi korlát (beleértve az átvitelt)
  • X-Credits-Remaining: <int> – mint korábban, de az átvitel figyelembevételével
  • X-Credits-Rollover: <int> – a jelenlegi átvitt hitelek egyenlege (csak éves előfizetők számára)
• A Pro terv ($59) most már nyíltan reklámozza: streamelési végpontok (valós időben), GDPR-kompatibilis EU-számlázás, kibővített MCP (multi-agent / vitatkozás / RAG), webhookok (10 típus). Ezek olyan funkciók, amelyek már a Pro-ban voltak – korábban a dokumentációban rejtve voltak.

Adatbázisséma: hozzáadva az credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED oszlopok az api_keys és shared_user_quotas táblákhoz. Kezdetben mindkettő = 0 minden meglévő kulcshoz.

2026-03-01 — Átlátható hitelköltség táblázat végpontonként

Elindítjuk a nyilvános /credits/ oldalt a teljes bontással az összes 700+ végpont hitelköltségéről. Egyetlen versenytárs sem (DivineAPI, AstrologyAPI, Prokerala) nem publikál ilyen táblázatot – ők fix 1 hitel/hívást számolnak és elrejtik a belső útválasztást.

Az integrátornak ez három dolgot ad:

• Átlátható gazdasági egység – a pontos $/hívás költsége minden végpontnál (a havi költségvetések /pricing/ × a terv költsége = valós költség hívásonként).
• Automatikus szinkronizálás a kóddal – a táblázat a build során generálódik a endpoint-costs.ts-ből. Ha új végpontot adunk hozzá vagy megváltoztatjuk a tarifát – az oldal automatikusan frissül a következő telepítéskor.
• Free terv jelölése – az oszlop mutatja, mely végpontok igényelnek Indie+ (🔒 ikon, jelenleg 28 végpont).

Elérhető: /credits/ (uk) és /en/credits/ (en). Kereszthivatkozások a /rate-limits-credits/-ról és bejegyzés az oldalsó navigációban Starlight («Új» ikon).

2026-02-27 — Vedikus térképek, kozmogram, napfogyatkozás útvonal, csillagtérkép (+6 végpont)

Lezárja a Vizualizáció kategóriát 14/14 végponttal a roadmap szerint:

• POST /v1/render/wheel-vedic-north – Észak-indiai (gyémánt) elrendezés. Házak rögzítettek, jelek forognak a lagnával.
• POST /v1/render/wheel-vedic-south – Dél-indiai (4×4 rács). Jelek rögzítettek (Halak bal felső), házak úsznak.
• POST /v1/render/wheel-vedic-east – Kelet-indiai (bengáli). Négyzet átlókkal + belső elforgatott négyzettel.
• POST /v1/render/cosmogram – Hamburgi iskola / Kozmobiológia 90°-os tárcsa (Ebertin 1940 + Witte 1928).
• POST /v1/render/eclipse-path – equirektanguláris világtérkép a hívó által megadott lat/lon nyomvonalával; rendereli a középső vonalat + a megadott szélességű sávot.
• POST /v1/render/star-map – sztereografikus vetítés pontok listájáról (RA/Dec) magnitude-skálázással.

Minden render tiszta SVG, fejlődési Chrome nélkül.

2026-02-25 — Bi-/tri-kerek + kompozit + bioritmus (+4 végpont)

Négy új vizualizációs végpont, amely kibővíti az SVG-mechanikát:

• POST /v1/render/bi-wheel – két koncentrikus kör: belső natalis + külső gyűrű tranzitív (vagy progresszív) bolygókkal.
• POST /v1/render/tri-wheel – három kör: natalis + progresszív + tranzitív.
• POST /v1/render/composite – kompozit térkép renderelése két natalis bemenetből (középponti kompozit).
• POST /v1/render/biorhythm – szinuszgörbe három ciklusnak: fizikai (23 nap), érzelmi (28), intellektuális (33).

A számítások itt ugyanazok, csak a renderelés; a bi-wheel esetében mindkét térkép összes bolygója párhuzamosan számítódik (Promise.all).

2026-02-24 — Vizualizáció: SVG-renderelés (+4 végpont)

Négy új végpont SVG-renderelést ad vissza natalis térképekről és kapcsolódó vizuális elemekről. Tiszta szerveroldali – Puppeteer/headless-Chrome nélkül, így a késés ~10 ms 1-2 s helyett, és ingyenes a free terv számára.

• POST /v1/render/wheel-western – nyugati kerék (jelek gyűrűje + házak gyűrűje + bolygók + aspektusvonalak).
• POST /v1/render/aspect-grid – háromszög alakú aspektusmátrix jelöléssel + orb a cellákban.
• POST /v1/render/moon-phase – Hold korong megvilágítással; visszaadja az SVG-t plusz illuminationFraction, phase, waxing.
• POST /v1/render/timeline – Gantt-stílusú idővonal események/tranzitok időszakra (a hívó átadja az events tömböt).

Opciók: size, theme (light / dark / console), format (json visszaadja { svg, byteLength }, svg közvetlenül adja vissza image/svg+xml). Alapvető szint – 2 hitel hívásonként.

2026-02-23 — Típusos sémák a /v1/openapi.json-ben (612 végpont, 98%)

A /v1/openapi.json mostantól teljes körű gép által olvasható specifikáció a kérés törzsekre és a válasz adatokra is. 612 a 624 POST-végpontból típusosítva van három egymást követő lépés során, amelyek együtt érkeztek:

• Kérés törzsek – 386 végpont típusosítva a components.schemas segítségével (128 újrafelhasználható komponens). Ezek között 5 közös (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) és 123 helyi (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern stb.). Kompozíció allOf segítségével az örökléshez (DashaInput extends ChartInput).
• Válasz data – 612 végpont típusosítva az inferrer segítségével, amely végigmegy az ep.response példákon a manifestben: {type: 'object', properties: {...}} a lapos {type: 'object'} helyett. A natalis térkép mostantól deklarálja a data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] valódi típusú mezőkkel.
• A maradék 12 végpont – dasha pratyantar/sookshma, amelyeknek nem egyértelmű shorthand példái vannak a manifestben – marad {type: object}. Visszafelé kompatibilis, hozzáadjuk őket a következő kiadásokban.

Mit jelent ez az integrátornak:

• Regenerálja az OpenAPI-klienst – a openapi-typescript, openapi-fetch, swagger-codegen interfészeket hoz létre típusos mezőkkel a Record<string, unknown> helyett. A kód-kiegészítés a kérés törzsekre + a válasz data-ra natívan működik.
• A Postman-gyűjtemény a /postman/astroway-api.json-ben frissült ugyanazokkal a típusokkal – importálja, kapja meg az automatikus kitöltést az összes típusos végpontnál.

Visszafelé kompatibilis: az előző forma {"type": "object"} permisszív volt – minden meglévő kliens továbbra is változatlanul működik.

2026-02-21 — Árak újraszámolása: Jelentések egyesítve, Business +500K, Free erősítve

Három árváltozás, amely az integrátorokat érinti:

• Jelentések egységesítve 5 000 hitelre – /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitab csökkentve 10 000 kr-ről 5 000 kr-re hívásonként (fele annyi). Minden PDF-jelentés mostantól ugyanannyiba kerül – egyszerűbb matematika a csomag költségvetéséhez.
• Business terv +500K hitel/hó – a Business terv mostantól 3 500 000 hitelt ad hónapra (korábban 3 000 000) ugyanazért az árért $199. A meglévő előfizetők automatikusan megkapják a növelt korlátot a következő számlázási ciklussal.
• Free terv: /v1/reports/* fizetős tervet igényel – 12 PDF-végpont (reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) mostantól 402 PLAN_UPGRADE_REQUIRED-t ad vissza a Free-kulcsok számára. A többi funkció – térképek, szinásztria, előrejelzések, horoszkóp – továbbra is elérhető a Free terven.

Ha a Free-kulcsa meghívott egy ezen végpontok közül – frissítsen Indie-ra ($5/hó) vagy magasabbra, vagy váltson a JSON-ekvivalensekre (/v1/chart, /v1/synastry stb.) ugyanolyan tartalomért PDF-renderelés nélkül.

2026-02-19 — Hitelesítés Google és GitHub segítségével (+2 végpont)

Egy fiók az egész ökoszisztémához – aki regisztrált az astroway.info-n vagy az app.astroway.info-n, beléphet a fejlesztői konzolba ugyanazzal az emaillel/SSO-val, láthatja a rendelési előzményeket, hiteleket és API-kulcsokat.

• GET /v1/auth/oauth/google/start?return=<path> – elindítja a Google OAuth folyamatot.
• GET /v1/auth/oauth/github/start?return=<path> – elindítja a GitHub OAuth folyamatot.

A visszahívás átirányítással zárul a /dashboard/oauth/callback#access_token=&refresh_token=&user=-re – a dashboard ezután megőrzi a tokeneket, mint a /v1/auth/login után. Ha az email már regisztrálva van a hagyományos űrlapon és email_verified=true a szolgáltatótól – a fiók összekapcsolódik, új nem jön létre.

2026-02-17 — Jelentések Csomag ($99 / 500 000 hitel) + white-label beépítve

Terv a PDF-jelentések fejlesztői számára – 100 PDF/hó $0.99 hatékonnyal, white-label alapértelmezés szerint:

• reports_pack terv ($99/hó vagy $990/év) 500 000 hitelt és 200 kérést/percet ad.
• Hozzáférés korlátozva a /reports/*-ra (12 típusú PDF: natalis, szinásztria, gyermek, üzlet, karrier, szerelem, pénz, tranzit éves, vedikus kundli, lal kitab, emberi tervezés, tarot) + /whitelabel/* (egyedi logó + színek + domain). Minden más 402 PLAN_PACK_MISMATCH-t ad vissza (upgrade_to: pro).
• White-label beépítve alapértelmezés szerint – nincs szükség Enterprise-re frissíteni a márkás PDF-ekhez.
• Túlfogyasztás $3 / 10 000 hitel (mint a Pro), költségkorlátozás kapcsolója elérhető.
• 21 nyelvi lokalizáció, A4 formátum, kézbesítés aláírt-URL CDN-n keresztül (TTL 24 óra).

API terv enum mostantól: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack. Új WC slug: astroway-api-reports-pack.

2026-02-15 — Keresztszakma: Jaimini jogák + Lal Kitab és KP doshák (+17 végpont)

Tizenhét végpont – lezárja a keresztszakmai vertikális jogok és doshák számára.

• Jaimini Jogák (5) – /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Alapul a chara karakák (AK / Amk / PK).
• Lal Kitab dosha változatok (6) – /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. LK-specifikus kivételek és upayák.
• KP dosha változatok (6) – /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. BPHS-szabályok + KP sub-lord lánc. Sade Sati – tranzit-érzékeny (igényel targetDate).

Források: Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI. Árazás: TIER_3 (50 hitel).

2026-02-13 — Vedic Csomag ($19 / 100 000 hitel)

Külön terv a Vedic-asztrológiához – 165 végpont a Starter áráért:

• vedic_pack terv ($19/hó vagy $190/év) 100 000 hitelt és 100 kérést/percet ad.
• Hozzáférés korlátozva a Vedic névterekre (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Minden más végpont 402 PLAN_PACK_MISMATCH-t ad vissza.
• Fedettség: 16 varga D1-D60, panchang (7), shadbala (7), jogák (7), doshák (7), kompatibilitás ashtakoot (6), muhurat (12 kategória), 8 dasha rendszer × 5 szint (40), KP, Lal Kitab, Jaimini.
• 2.5-5× több térkép ugyanazért az árért, mint a Prokerala Ruby (~5K kundlis/hó vs ők 1-2K).

API terv enum mostantól: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. Új WC slug: astroway-api-vedic-pack.

2026-02-09 — Lal Kitab: teljes csomag (+12 végpont)

Tizenkét végpont az Észak-indiai Vedic iskolából az anonim Urdu MSS 1939-1952 alapján. Az egész iskola – SÁRGA (belső – egyiskolás, eltérések a modern szerzők között).

• /vedic/lal-kitab/teva – rögzített házú térkép (ház = jel).
• /vedic/lal-kitab/lal-kundali – 12-házas rács elrendezés.
• /vedic/lal-kitab/kismat + /prosperity – szerencse & dhana yoga pontozás.
• /vedic/lal-kitab/dasha (35y) + /varshphal + /life-graph – időzítés.
• /vedic/lal-kitab/debts – 6 Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) észlelés + gyógyítás.
• /vedic/lal-kitab/remedies – bolygónkénti upayák (nap / mantra / adomány).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

A nyilatkozat a válaszokban megjelenik. Források: K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Esoteric Csomag ($9 / 200 000 hitel)

Új kiegészítő terv az ezotéria/divináció fejlesztői számára – 180 végpont $9/hóért:

• esoteric_pack terv ($9/hó vagy $90/év) 200 000 hitelt és 60 kérést/percet ad.
• Hozzáférés korlátozva az ezotéria/divináció területekre (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Minden más végpont 402 PLAN_PACK_MISMATCH-t ad vissza.
• Nem kombinálható más tervvel ugyanazon a kulcson – ez egy külön kiterjesztés, mint a HD Csomag.

API terv enum mostantól: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. Új WC slug-ok: astroway-api-esoteric-pack (havi + éves változatok). Ha kulcsokat hozott létre a /v1/keys segítségével explicit plan nélkül – semmi nem változik.

2026-02-02 — BaZi + Zi Wei Dou Shu (+17 végpont)

Harmadik kínai kategória, a Kínai Zodiákus + Feng Shui után:

• BaZi (5) – /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. Az év + hónap pillérek kanonikusak, a nap + óra pillérek későbbre halasztva a Hong Kong Observatory-vel való keresztellenőrzés miatt (különböző források különböző JD-horgonyokat adnak).
• 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 – palota jelentések + 14 főcsillag lista. A teljes térkép későbbre halasztva (szakosodott holdhónap ephemeris szükséges).

Az API mostantól 505 végpontot tesz elérhetővé – párhuzamosan a szélesebb versenytárssal (Astrology-API.io).

2026-01-30 — Jól-lét (+9 végpont)

Kilenc jól-lét végpont – orvosi asztrológia + étrend + jógá + kristályok stb. Kizárólag oktatási célra – nem orvosi tanács, nyilatkozat minden válaszban.

• POST /v1/wellness/medical-astrology – test-uralom a hagyományos Melothesia szerint.
• POST /v1/wellness/diet – étel az elem szerint (fókusz / hangsúlyozás / elkerülés).
• POST /v1/wellness/yoga – fókusz + asanák + pranajama a jel szerint.
• POST /v1/wellness/exercise – intenzitás + ajánlott/elkerülendő az elem szerint.
• POST /v1/wellness/mental-health – elem-profil tükrök + dominantElement + erős/gyenge oldalak + megküzdés.
• POST /v1/wellness/sleep-cycles – alvási tanácsok a Hold fázisai szerint.
• POST /v1/wellness/herbs – gyógynövények a jel bolygó uralkodója szerint (Culpeper 1653).
• POST /v1/wellness/crystals – kristályok a jel + szándék szerint.
• POST /v1/wellness/cycle – életkor alapú jól-lét mérföldkövek (Szaturnusz visszatérés, Uránusz ellenállás, …).

Források: Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Szint – 2 hitel (ciklus = 1 hitel).

2026-01-27 — Maják naptárai (+8 végpont)

Maják blokk: klasszikus Tzolkin + Haab + Hosszú Számláló + Naptári Kör + Az Éjszaka Ura, plusz Dreamspell (modern Argüelles 1990).

• POST /v1/mayan/tzolkin – 260 napos szent naptár (szám 1-13 + név 20-ból).
• POST /v1/mayan/haab – 365 napos polgári naptár (18 hónap × 20 + 5 napos Wayeb).
• POST /v1/mayan/long-count – 5 helyi pozíciós jelölés baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round – kombinált Tzolkin+Haab (52 éves ciklus).
• POST /v1/mayan/lord-of-night – 9 napos ciklus (G1-G9).
• POST /v1/mayan/full – minden klasszikus egy hívásban.
• POST /v1/mayan/compatibility – pár kompatibilitása hang/név/elemt/irány szerint.
• POST /v1/mayan/dreamspell – modern Argüelles (kin 1-260, hang × pecsét).

Forrás: Goodman-Martínez-Thompson korreláció (Thompson 1935 + Lounsbury 1976). Érvényesítési horgony: 2012-12-21 = Hosszú Számláló 13.0.0.0.0 ✓ (Bak’tun átváltás).

2026-01-23 — Sthira + Shoola Dasha (+10 végpont)

Két Jaimini-iskola rasi-dasha teljes kaskáddal (maha, antar, pratyantar, sookshma, prana):

• Sthira – mag = Brahma bolygó jel, MD előre 12 jel (7y mozgó / 8y rögzített / 9y kettős).
• Shoola – mag = stronger_rasi(asc, asc+6), MD előre 12×9y, opció antardasaSeedOption ∈ 3.

Lezárja a 10 dasha-iskola × 5 szint = 50 végpont készletét. Források: BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

2026-01-19 — Állat + Üzlet + Pénzügy (+36 végpont)

Három kategória egy szállítmányban:

• Állat (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}. Nyilatkozat: kizárólag szórakoztatásra – nem állatorvosi ellátás.
• Üzlet (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}. Nyilatkozat: stratégiai ötletelés, nem jogi/adó tanács.
• Pénzügy (10) – /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}. ⚠️ NEM BESZÁLLÍTÁSI TANÁCS – megerősített nyilatkozat minden válaszban.

Szint – 2 hitel (Pénzügy piac-időzítés/gazdagság-ciklus = 3 hitel).

2026-01-16 — Jaimini elemzési csomag (+10 végpont)

Tíz Jaimini-elemzési végpont – chara/naisargika karakák, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK a D9-ben), futó dasha összegzés, alapvető Jaimini jogák.

Források: Jaimini Sutras 1-2 + BPHS Adhyayas 26/47.

2026-01-09 — Státusz oldal + AI-ügynökök + alapértelmezett alap URL

• Nyilvános státusz oldal: https://api.astroway.info/status – rendelkezésre állás, késleltetés p50/p95/p99, 60s cache-el.
• llms.txt AI-ügynököknek: https://api.astroway.info/llms.txt – strukturált utasítások a Claude / ChatGPT / Perplexity Code ügynökök számára.
• Alapértelmezett alap URL a dokumentációban, MCP szerver, SDK-k, Postman gyűjtemény – api.astroway.info/v1 (301 átirányítással a régi api-calc.astroway.info-ről).

2025-12-30 — Tribhagi, Shatabdika, Shodashottari Dashák (+15 végpont)

Három nakshatra-dasha rendszer teljes kaskáddal:

• Tribhagi – 1/3 méretű Vimshottari (40 éves ciklus).
• Shatabdika – 100 éves ciklus, 7 bolygó (nincs árnyék).
• Shodashottari – 116 éves ciklus, 8 bolygó (nincs Rahu).

Források: BPHS Adhyaya 46.

2025-12-25 — Hitelcsomagok: 5-szintű újraegyensúlyozás + Free 5K → 10K

Újraegyensúlyoztuk a hitel szinteket 18 versenytárs audit után. A Free terv mostantól 10 000 hitelt ad hónapra (korábban 5 000). A tipikus használati esetek költségei (natalis térkép + 7 tranzit) ~22%-kal csökkentek. Nincs töri változás az API-ban – csak a gazdaság.

2025-12-17 — Kínai Zodiákus + Feng Shui Kua (+8 végpont)

Az első kínai asztrológiai blokk, alap réteg (BaZi + Zi Wei Dou Shu – később):

• POST /v1/chinese/zodiac/animal – év állata + teljes pillér (Geng-Wu, Wood-yang, stb.).
• POST /v1/chinese/zodiac/element – rögzített + ciklikus Wu Xing elem yin/yang-gal.
• POST /v1/chinese/zodiac/inner-animal – belső állat (ág hónap).
• POST /v1/chinese/zodiac/secret-animal – titkos állat (ág óra – time szükséges).
• POST /v1/chinese/zodiac/compatibility – pár kompatibilitás San He trinák / Liu Chong konfliktus párok szerint.
• POST /v1/chinese/feng-shui/kua – személyes Kua-szám + Kelet/Nyugat csoport.
• POST /v1/chinese/feng-shui/lucky-directions – 4 szerencsés + 4 szerencsétlen iránytű irány.
• POST /v1/chinese/feng-shui/bagua – Bagua térkép 9 élet terület elemekkel + színekkel.

Forrás: 60-jiazi kanonikus + L. Skinner Living Earth Manual (1976) + Lillian Too. Árazási szint – 2 hitel hívásonként. Lichun határ = február 4 (pontosság ±1 nap 1900–2100 között).

2025-12-09 — Minőségellenőrzés: 24 hibajavítás a Vedic kategóriákban

24 számítási hiba javítása 6 párhuzamos mély kutatási ügynök segítségével. A legkritikusabbak: Mangal dosha megszűntetés (saját/kitüntetett Mars megszünteti a BPHS szerint), Pitru dosha indító (Nap-Szaturnusz vs Nap-Ráhu), kompozit Davison ARMC csúszás, ACG meridiánvonal pontossága. Hozzáadva snapshot tesztek: 47.

2025-12-02 — Vedic Kompatibilitás + Muhurat (+18 végpont)

• Kompatibilitás (6) – Ashta-Koota illesztés (Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi) + Mangal dosha kompatibilitás + Bhrigu összegz