Changelog що нового

Усі зміни, що впливають на код інтегратора: нові ендпоінти, оновлення SDK, зміни в /openapi.json, правки цін у кредитах, deprecation, breaking changes. Найновіші — згори. Внутрішні зміни сайту тут не фіксуються.

API-контракт стабільний у межах /v1/* — будь-яке breaking-зміна виходить під /v2/*, а /v1/* продовжує працювати щонайменше 12 місяців.

2026-05-29 — Чотири нові embed-віджети (без ключа, для iframe)

Розширено набір публічних HTML-віджетів GET /v1/embed/* — тепер їх 14. Нові не потребують API-ключа, віддають готовий iframe-фрагмент, обмежені per-IP (30 запитів/год).

• GET /v1/embed/transit?date= — позиції транзитних планет (знак + градус, ретроградність) на дату.
• GET /v1/embed/numerology?name=&date=&system= — Число життєвого шляху / вираження / душі / особистості (system: pythagorean або chaldean).
• GET /v1/embed/panchang?date=&lat=&lng=&tz= — тітхі / накшатра / йоґа / карана / вара + схід/захід Сонця + Раху-каал.
• GET /v1/embed/synastry?date_a=&time_a=&lat_a=&lng_a=&tz_a=&date_b=… — оцінка сумісності + ключові міжкартові аспекти для двох субʼєктів.

<iframe src="https://api.astroway.info/v1/embed/transit?date=2026-05-29&theme=dark"
        width="460" height="420" style="border:0"></iframe>

Усі віджети приймають theme (dark/light/console) та lang. Кешуються public, max-age=300.

2026-05-26 — Новий ендпоінт POST /v1/reports/generate — V2 unified dispatcher

Замість 12 type-specific роутів (/reports/natal, /reports/synastry, …) — один ендпоінт із report_type enum, який диспатчить на відповідний рендерер. SDK-консументи отримують один метод замість дванадцяти; MCP-каталог — один інструмент замість дванадцяти.

curl -X POST https://api.astroway.info/v1/reports/generate \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "report_type": "natal",
    "chart": {"date":"1990-05-15","time":"14:30","timezoneOffset":3,"latitude":50.45,"longitude":30.52,"name":"Test"},
    "language": "uk",
    "whitelabel": { "themeColor": "#ff5500", "reportName": "My Cosmic Map" }
  }'

12 supported report_type values: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Per-type required fields validated в handler: natal/business/career/etc — chart; synastry — chart1 + chart2; tarot — seed (optional). Missing required fields → 400 with MISSING_CHART / MISSING_CHARTS error code.

Зворотна сумісність. Всі 12 type-specific ендпоінтів залишаються — /v1/reports/generate додано як additive surface, не replacement. Можна вибрати або: direct (client.reports.natal({...})) або generic (client.reports.generate({ report_type: 'natal', ... })).

Pricing. Forwarded per-renderer (natal → TIER_7, transit-yearly → TIER_8, tarot → TIER_4, тощо). Сам dispatcher не додає окремої вартості.

OpenAPI 3.1. GenerateReport — окремий компонент в /v1/openapi.json. SDK regen у наступному релізі додасть метод client.reports.generate().

2026-05-25 — Jaimini-розширення (+5 ендпоінтів)

П’ять нових ендпоінтів для глибокого аналізу за школою Jaimini — раніше були відкладені, тепер у проді.

• POST /vedic/yogas/jaimini/karaka-yoga — скан усіх 8 чара-карак (Atmakaraka..Darakaraka) з оцінкою сили розміщення в кендрі / тріні / душтхані та підказкою маніфестації для кожної.
• POST /vedic/yogas/jaimini/karakamsa — повна 12-будинкова проекція з знаку Атмакараки в D9. Кожен будинок несе канонічні значення (іштадевата, мокша, духовний шлях) за коментарем Sanjay Rath.
• POST /vedic/yogas/jaimini/shubha-graha — функціональна природа всіх 7 видимих грах (yogakaraka / functional-benefic / neutral / functional-malefic / maraka) залежно від володіння будинками від Лагни. Кендрадхіпаті- + мараку-правила за BPHS A.34.
• POST /vedic/jaimini/atmakaraka-rotation — таймлайн зміни Атмакараки протягом життя через символічну прогресію 1°/рік. Повертає вік-події з ім’ям планети до/після переходу.
• POST /vedic/jaimini/argala-analysis — повний скан Argala (2/4/11 первинна, 5 вторинна, 8 спеціальна) + Virodhargala (12/10/3 первинна, 9 вторинна, 6 спеціальна) для всіх 12 будинків з net-influence та dominant-over.

Усі п’ять — окремі вартісні групи (Tier 2 — 20 кредитів, окрім atmakaraka-rotation Tier 3 — 50 кредитів через time-series compute). Доступні на Vedic Pack add-on.

2026-05-19 — whitelabel приймає inline-об’єкт брендингу (15 полів)

Поле whitelabel у схемах усіх 12 ендпоінтів /v1/reports/* (natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli) тепер приймає не лише boolean, а й об’єкт із брендингом — без необхідності прив’язки до WordPress-користувача через whitelabel_configs таблицю.

curl -X POST https://api.astroway.info/v1/reports/natal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "chart": {"date":"1990-05-15","time":"14:30","timezoneOffset":3,"latitude":50.45,"longitude":30.52,"name":"Test"},
    "whitelabel": {
      "companyName": "Acme Astrology",
      "companyUrl": "https://acme-astro.example.com",
      "logoUrl": "https://cdn.example.com/logo.png",
      "themeColor": "#ff5500",
      "reportName": "My Personal Cosmic Map",
      "footerText": "© 2026 Acme Astrology",
      "fontPairing": "serif-sans"
    }
  }'

PDF/HTML рендериться з вашим лого в шапці, заміненою назвою звіту, відповідними кольорами теми та блоком контактів у футері.

15 полів об’єкта (усі опціональні): companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl (https + .png/.jpg/.svg/.webp), frontImage, textPrimaryColor/textSecondaryColor/backgroundColor/themeColor/headingColor (всі #RGB або #RRGGBB), footerText, fontPairing (serif-sans/sans-serif/serif-only/sans-only/system), reportName.

Зворотна сумісність. whitelabel: true (читає DB-конфіг для прив’язаного WP-користувача) та whitelabel: false/відсутнє — поведінка незмінна. Поле тепер boolean | BrandingObject.

Resolution priority. Inline-об’єкт зливається поверх DB-конфігу (якщо ключ прив’язано до WP-користувача) або поверх дефолтів (для SDK-користувачів без WP). themeColor стає primaryColor після applyBrandingPreferences, fontPairing мапиться на CSS font-family.

OpenAPI 3.1 spec. BrandingObject — окремий компонент у /v1/openapi.json. SDK-кодген отримає типізований BrandingObject під час наступної регенерації (TS / Python / PHP).

2026-05-16 — Hosted MCP endpoint live at mcp.astroway.info/mcp

@astroway/mcp тепер доступний у двох транспортних режимах. Stdio (npm-пакет) залишається без змін; додано hosted Streamable HTTP endpoint для zero-install інтеграції в Claude Web (claude.ai у браузері), Claude Desktop, Cursor, Cline та інші MCP-сумісні клієнти.

Установка в один клік для Cursor — кнопка cursor://anysphere.cursor-deeplink/mcp/install?... на сторінці /examples/mcp/. Claude Desktop — через + → Add Connector → Custom (без редагування JSON).

// JSON-варіант для Cline / Continue / Windsurf
{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Той самий каталог 630 інструментів + 12 промптів + 14 ресурсів, та сама aw_test_* / aw_live_* авторизація (у hosted режимі через Authorization: Bearer … header замість env var), той самий credit pool. Multi-tenant by design — кожен запит несе свій ключ, кредити списуються з акаунта власника ключа. Канал у X-Astroway-Channel — mcp-http (hosted) vs mcp (stdio) для adoption tracking.

Чому два режими. Stdio (npx @astroway/mcp) залишається для Cursor power users / privacy-conscious інтеграторів — ключ ніколи не залишає машину, без мережевих хопів. Hosted закриває сегмент Claude Web (який підтримує тільки remote MCP) та zero-install scenarios. Той самий шаблон, що у Stripe / Resend / GitHub MCP.

Health endpoint — публічно reachable без авторизації:

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

Повна документація обох режимів — /examples/mcp/.

2026-05-15 — Новий ендпоінт GET /v1/auth/keys/me

Інтроспекція API-ключа. Передаєш X-Api-Key — отримуєш повний стан: план, кредити, статус, прив’язаний домен, час створення, джерело реєстрації. Корисно для SDK-консумерів (TS / Python / PHP / MCP) — “що в мене за ключ зараз” без read’у дашборду. Аналог Stripe /v1/account або GitHub /user.

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # перші 11 символів, повний ключ ніколи не повертаємо
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # календарний кінець місяця
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # домен, до якого ключ прив'язано (wp-plugin keys)
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

Без auth: 401 MISSING_API_KEY. Невалідний ключ: 401 INVALID_API_KEY.

OpenAPI 3.1 spec. /v1/openapi.json тепер декларує /v1/auth/keys/me. SDK-кодген пропише client.auth.keys.me() під час наступної регенерації.

Зворотна сумісність. Старий GET /v1/keys/usage (повертав тільки credits_today + ratelimit) продовжує працювати — це окремий ендпоінт для серверних cron-перевірок. /auth/keys/me повертає повний state plus domain binding для wp-plugin сценаріїв.

2026-05-14 — Локалізація /horoscope/* та /interpret/* (21 мова)

POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility} та POST /v1/interpret/{natal,synastry,transits,element,placement} — 10 ендпоінтів, що повертають текст інтерпретації — тепер віддають відповідь у мові клієнта.

Як підключити:

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"}'
# → відповідь у हिन्दी

Resolve-priority (server-side):

1. body.language="de" — явний per-call параметр (вищий пріоритет)
2. Accept-Language: de, en;q=0.7 — RFC 7231 q-weighted; перший код, що збігається з активною мовою, виграє
3. ?lang=de — query-параметр для клієнтів, що не контролюють заголовки
4. Fallback → uk (джерельна мова)

Підтримувані мови (21): uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id. Невідомі коди тихо падають у uk без помилок.

OpenAPI 3.1 spec. /v1/openapi.json тепер декларує Accept-Language (header) та lang (query) як параметри з enum 21 кодів на цих 10 ендпоінтах. SDK-кодген (openapi-typescript, openapi-generator-cli) автоматично пропише типізовані виклики .lang('hi') під час наступної регенерації.

Що перекладається: тільки текстові поля інтерпретації (horoscope, interpretation, disclaimer тощо). Числові поля (longitude, latitude, score, ID-знаків, ID-домів) залишаються канонічними — клієнт форматує локально. Сегментний стандарт (Vedika, DivineAPI, AstrologyAPI.com).

Скоуп: наразі локалізуються 10 ендпоінтів інтерпретаційної групи. Калькуляційні ендпоінти (/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690 інших) повертають числа й канонічні ідентифікатори (name: "Aries", glyph: "♈") незмінно — клієнт локалізує їх через свої lookup-таблиці. Це сегментний стандарт.

Backwards compatible. Існуючий код без Accept-Language / ?lang= / body.language отримує uk за замовчуванням, як і раніше.

SDK-підтримка (@astroway/sdk, astroway, astroway/sdk, @astroway/mcp) додає lang опцію в конструкторі — окремі релізи приходять найближчими тижнями через cron-applier на staging-репозиторіях.

2026-05-09 — Three SDKs launched: TypeScript, Python, PHP

Три офіційних SDK живуть на public registries — обертки навколо тих самих 700+ ендпоінтів API. Один OpenAPI 3.1 spec → три language-idiomatic клієнти.

Що це для інтегратора:

• Type-safe alternative до raw HTTP. Path autocomplete + типи запитів і відповідей в IDE. Helper-методи aw.post('/chart', body=...) (Python/PHP) або aw.client.POST('/chart', { body }) (TS) — замість ручного fetch / requests / Guzzle.
• Identical surface across languages. Constructor Astroway({apiKey, baseUrl, authScheme, timeout, retry}) працює однаково в TS / Python / PHP. Якщо проект мульти-мовний — менше cognitive overhead.
• Built-in retry на 408/409/429/5xx з exponential backoff + full jitter. Honors Retry-After header. Default 2 retries, configurable через retry={maxRetries: 0}.
• Stainless-template ієрархія помилок — той самий шаблон що в SDK Stripe / OpenAI / Cloudflare. Ловіть RateLimitError (з retryAfterSeconds), AuthenticationError (rotate key), BadRequestError (validation), ApiError (generic) — у такому порядку.
• Two auth schemes. За замовчуванням X-Api-Key: aw_live_... (як у curl/Postman). Або Authorization: Bearer aw_live_... (як у Stripe/OpenAI/Anthropic SDK) — auth_scheme="bearer" в конструкторі.
• Identification headers, no telemetry. Кожен запит несе User-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>. Жодного phone-home, жодного opt-in/opt-out перемикача.
• OIDC + SLSA L3 provenance (TS + Python). Sigstore-attested record що пакет збудований з конкретного коміту в публічному репо. Без long-lived tokens у CI.
• MIT, full source open на 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', /* ... */]);

Async варіант для Python — AsyncAstroway з identical surface через async/await. У PHP — sync only (PHP не має unified async story). У TS — native promises на base of openapi-fetch.

Це alpha — public API може зміщуватися до 0.1.0 proper на основі feedback інтеграторів. Закріпіть точну версію (@astroway/sdk@0.1.0-alpha.1) під час alpha-вікна — або latest alpha на момент install.

@astroway/mcp — MCP-сервер для Claude / Cursor / GPT — продовжує жити поряд як окремий продукт.

2026-05-07 — MCP server refresh

@astroway/mcp оновився — auto-генерує tool catalog з поточного /openapi.json без ручного редагування. Все, що з’явилося в API за останні тижні (compat suite, reports endpoints), одразу видно Claude / Cursor / GPT.

Для інтегратора:

• Tool catalog відображає живий стан API
• Path-template ендпоінти (/v1/.../id) пропускаються поки що, щоб не плутати дискріб-парсер
• Cost annotations в description tool — Claude бачить вартість виклику до execution
• OIDC trusted publishing + SLSA L3 provenance — пакет attested до конкретного коміту в public repo astroway/astroway-mcp

Установка:

npm install -g @astroway/mcp

Або через Claude Desktop / Cursor MCP config:

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

Source: public astroway/astroway-mcp (MIT).

2026-04-11 — Cross-system compatibility (+10 ендпоінтів)

Нова група /v1/compat/* — composite compatibility score across western, vedic, chinese, numerology, tarot, human design. 6 систем дають unified метрику для UX-індикаторів у multi-traditional астрологічних застосунках.

Кожен ендпоінт повертає JSON з полем disclaimer — це AstroWay scoring methodology, не клінічне або юридичне ствердження. Tier 4 (100 кредитів) per call — heavy cross-system compute.

Manifest на /openapi.json оновлено — SDK / MCP підхоплять автоматично.

2026-03-28 — Reports + Webhooks (+17 ендпоінтів)

Дві нові групи в production.

/v1/reports/* (12 ендпоінтів) — генерація HTML / PDF репортів через Puppeteer. Render на стороні api-calc, signed download URL (TTL 24h).

/v1/webhooks/* (5 ендпоінтів) — subscription management, event delivery, HMAC signing. Підписка на події 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_..."}'

Кожен delivery несе X-Astroway-Signature: sha256=<hmac> — verify через secret. Retry policy: exponential backoff на 5xx, до 5 спроб за 24 години.

2026-03-14 — Reference endpoints: public, без ключа, без кредитів

14 ендпоінтів /v1/reference/* (signs, planets, houses, aspects, elements, modalities, polarities, dignities, decans, nakshatras, lots, asteroids, zodiac-systems, glyphs) тепер працюють без X-Api-Key і коштують 0 кредитів. Це канонічні lookup-таблиці — гейтити їх через білінг було проектним недоглядом.

Що це для інтегратора:

• Виклик без ключа — зовнішні MCP-агенти / SDK / прев’ю-сторінки можуть тягнути reference дані без авторизації. IP rate-limit як на /public (30 запитів / годину) залишається.
• Cost manifest оновлено — 14 шляхів пере́йшли з TIER_HALF (5 кредитів) на 0. Якщо ваш бюджет-планер astroway_cost_estimate посилається на ці шляхи — нові виклики не торкають квоту.
• Існуючі клієнти з ключем працюють без змін. X-Api-Key ігнорується для /reference/* (не прискіплюємось до зайвого header’а).

Backward-compatible: 200-відповіді й JSON-схема не змінюються, лише вимога авторизації знята.

2026-03-07 — Founders’ Lifetime Deal: $299 → тариф Indie на все життя

Запускаємо Founders’ Lifetime Deal — обмежений запуск. Перші 100 клієнтів платять $299 одноразово і отримують тариф Indie (50 000 кредитів/міс) назавжди, без рекурентних списань, із зафіксованою ціною.

Що це для інтеграторів:

• Стандартний Indie = $5/міс. Founders’ = одноразово $299 → точка окупності на 5-му році, далі безмежний ROI. Якщо ваш проєкт хоча б 5 років в астрології / нумерології / Таро — Founders’ окупається.
• Webhook payload на checkout SKU astroway-api-indie-lifetime: рядок api_keys отримує plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. Жодних щомісячних списань, жодних renewal-вебхуків.
• Схема БД: додано колонки is_lifetime TINYINT(1) в api_keys і shared_user_quotas. TS-тип ApiKeyInfo розширено. Існуючі ключі = is_lifetime=0 (без зміни поведінки).
• WP REST endpoint GET /wp-json/astroway/v1/founders-count повертає {sold, total: 100, remaining, available} — використовується site/components/founders/FoundersCounter.astro для лічильника в реальному часі на сторінці /founders/.
• Авто-деактивація на 100/100: _stock_status товару WC автоматично переходить в outofstock через хук WC woocommerce_order_status_completed. Після цього посилання checkout перенаправляє на /pricing/#indie (стандартний Indie $5/міс).

Live pages: /founders/ (uk) + /en/founders/ (en). Sidebar entry “Founders’ Lifetime Deal” з 🚀 100 only badge.

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

2026-03-05 — GDPR / EU residency landing page + Pro card EU badge

Запускаємо /eu/ — окрему сторінку для EU-розробників, чий продукт чутливий до GDPR. Інтегратору важливо знати:

• Pro $59 = EU-резидентність за замовчуванням (Hetzner Nuremberg, потік даних тільки в межах ЄС, анонімізована аналітика — Plausible cookie-free у роадмапі).
• Стандартний DPA доступний не тільки на Enterprise — підписується через email на стандартному тарифі Pro за 5 робочих днів.
• DELETE /v1/me/account — ендпоінт для GDPR right-to-erasure (миттєво видаляє ваш wp_user_id з усіх таблиць).
• Картка Pro на /pricing/ тепер має значок 🇪🇺 GDPR-ready — клік веде на /eu/ з повним FAQ.
• DivineAPI / AstrologyAPI / Prokerala — хостинг US/Індія, DPA тільки на Enterprise. Якщо відповідність GDPR критична — Pro $59 найдешевший шлях.

Сторінки: /eu/ (uk) + /en/eu/ (en). Запис у боковій навігації «GDPR / EU residency» зі значком 🇪🇺.

2026-03-03 — Річна передоплата −25% + перенесення кредитів + публічні фічі Pro

Дві зміни, що впливають на код інтеграторів:

• Річна знижка 17% → 25% (3 місяці безкоштовно замість 2). Нові USD-ціни на рік: Indie $45, Starter $171, Pro $531, Business $1791, HD/Esoteric Pack $81, Vedic Pack $171, Reports Pack $891. Існуючі річні підписники не зачіпаються — нова ціна застосовується лише до майбутніх поновлень підписки. Якщо ви парсили USD-ціни через /wp-json/astroway/v1/api-prices — оновлені значення тепер віддаються автоматично.
• Перенесення кредитів для річних підписників: невикористані кредити переходять на наступний місячний цикл, обмежені 1× місячним лімітом тарифу. Активується автоматично при оформленні річного плану. Видно через нові заголовки відповіді:
  • X-Credits-Limit: <int> — ефективний місячний ліміт (включає перенесення)
  • X-Credits-Remaining: <int> — як було, але з урахуванням перенесення
  • X-Credits-Rollover: <int> — поточний баланс перенесених кредитів (тільки для річних)
• Тариф Pro ($59) тепер відкрито рекламує: streaming-ендпоінти (в реальному часі), GDPR-сумісний ЄС-білінг, розширений MCP (multi-agent / debate / RAG), webhooks (10 типів). Це функції, що вже були в Pro — раніше були сховані в docs.

Схема БД: додано колонки credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED в api_keys і shared_user_quotas. На початку — обидві = 0 для всіх існуючих ключів.

2026-03-01 — Прозора таблиця вартості кредитів за ендпоінт

Запускаємо публічну сторінку /credits/ з повною розбивкою кредитів по всіх 700+ ендпоінтах. Жоден конкурент (DivineAPI, AstrologyAPI, Prokerala) такої таблиці не публікує — вони беруть фіксований 1 кредит/виклик і приховують внутрішнє маршрутизацію.

Для інтегратора це дає три речі:

• Прозора одиниця економіки — точна вартість $/виклик для кожного ендпоінта (місячні бюджети /pricing/ × вартість тарифу = реальна вартість за виклик).
• Авто-синхронізація з кодом — таблиця генерується під час білду з endpoint-costs.ts. Якщо ми додаємо новий ендпоінт або міняємо тариф — сторінка оновлюється автоматично на наступному деплої.
• Маркер Free-тарифу — колонка показує які ендпоінти потребують Indie+ (значок 🔒, 28 ендпоінтів зараз).

Доступно: /credits/ (uk) і /en/credits/ (en). Перехресні посилання з /rate-limits-credits/ і запис у боковій навігації Starlight (значок «Нове»).

2026-02-27 — Vedic-карти, cosmogram, eclipse-path, star-map (+6 ендпоінтів)

Закриває категорію Visualization на 14/14 ендпоінтів за роадмапом:

• POST /v1/render/wheel-vedic-north — North Indian (diamond) layout. Houses fixed, signs rotate за лагною.
• POST /v1/render/wheel-vedic-south — South Indian (4×4 grid). Signs fixed (Pisces top-left), houses плавають.
• POST /v1/render/wheel-vedic-east — East Indian (Bengali). Квадрат із діагоналями + внутрішнім повернутим квадратом.
• POST /v1/render/cosmogram — Hamburg School / Cosmobiology 90°-дайл (Ebertin 1940 + Witte 1928).
• POST /v1/render/eclipse-path — equirectangular world map з caller-supplied lat/lon-треком; рендерить центральну лінію + смугу заданої ширини.
• POST /v1/render/star-map — stereographic projection списку точок (RA/Dec) із magnitude-масштабуванням.

Усі рендери — pure SVG, без headless-Chrome.

2026-02-25 — Bi-/tri-wheel + composite + biorhythm (+4 ендпоінти)

Чотири нові ендпоінти-візуалізатори, що розширюють SVG-механіку:

• POST /v1/render/bi-wheel — два концентричні кола: внутрішнє натальне + зовнішнє кільце з транзитними (або прогресивними) планетами.
• POST /v1/render/tri-wheel — три кола: natal + progressed + transit.
• POST /v1/render/composite — рендер композитної карти з двох натальних вхідних даних (midpoint composite).
• POST /v1/render/biorhythm — синусоїдальний графік трьох циклів: фізичний (23 дні), емоційний (28), інтелектуальний (33).

Обчислення тут самі, лише рендер; для bi-wheel всі планети двох карт обчислюються паралельно (Promise.all).

2026-02-24 — Візуалізація: SVG-рендеринг (+4 ендпоінти)

Чотири нові ендпоінти повертають SVG-рендери натальних карт і пов’язаних візуалів. Pure server-side — без Puppeteer/headless-Chrome, тому затримка ~10 ms замість 1-2 с і безкоштовно для free-плану.

• POST /v1/render/wheel-western — західне колесо (signs ring + houses ring + planets + aspect lines).
• POST /v1/render/aspect-grid — трикутна матриця аспектів зі знаком + орбом у клітинках.
• POST /v1/render/moon-phase — диск Місяця з освітленням; повертає SVG плюс illuminationFraction, phase, waxing.
• POST /v1/render/timeline — Gantt-стиль для подій-транзитів за період (caller передає масив events).

Опції: size, theme (light / dark / console), format (json повертає { svg, byteLength }, svg віддає image/svg+xml напряму). Базовий tier — 2 кредити за виклик.

2026-02-23 — Типізовані схеми у /v1/openapi.json (612 ендпоінтів, 98%)

/v1/openapi.json тепер повноцінна машинно-читана специфікація і для request bodies, і для response data. Типізовано 612 з 624 POST-ендпоінтів через три послідовні етапи, що приземлились разом:

• Request bodies — 386 ендпоінтів типізовано через components.schemas (128 reusable-компонентів). Серед них 5 спільних (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) і 123 локальних (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern тощо). Композиція через allOf для inheritance (DashaInput extends ChartInput).
• Response data — 612 ендпоінтів типізовано через inferrer, що ходить ep.response-прикладами в маніфесті: {type: 'object', properties: {...}} замість плоского {type: 'object'}. Натальна карта тепер декларує data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] зі справжніми типами полів.
• Залишок 12 ендпоінтів — dasha pratyantar/sookshma з нерозбірливими shorthand-прикладами в маніфесті — залишаються {type: object}. Backward-compatible, додаємо їх у наступних релізах.

Що це для інтегратора:

• Перегенеруйте OpenAPI-клієнт — openapi-typescript, openapi-fetch, swagger-codegen створять інтерфейси з типизованими полями замість Record<string, unknown>. Code-completion на request bodies + response data працює нативно.
• Postman-колекція на /postman/astroway-api.json оновилась з тих самих типів — імпортуйте, отримайте автозаповнення для всіх типизованих ендпоінтів.

Backward-compatible: попередня форма {"type": "object"} була permissive — всі існуючі клієнти продовжують працювати без змін.

2026-02-21 — Перерахунок цін: Reports об’єднано, Business +500K, Free посилено

Три зміни цін, що впливають на інтеграторів:

• Reports уніфіковано на 5 000 кредитів — /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitab зменшено з 10 000 кр до 5 000 кр за виклик (вдвічі дешевше). Усі PDF-репорти тепер коштують однаково — простіша математика для пакетного бюджету.
• План Business +500K кредитів/міс — тариф Business тепер дає 3 500 000 кредитів на місяць (було 3 000 000) за ту саму ціну $199. Існуючі підписники отримають збільшений ліміт автоматично з наступного циклу білінгу.
• План Free: /v1/reports/* потребує платного тарифу — 12 PDF-ендпоінтів (reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) тепер повертають 402 PLAN_UPGRADE_REQUIRED для Free-ключів. Решта функціональності — карти, синастрія, прогнози, гороскоп — залишається доступною на Free.

Якщо ваш Free-ключ викликав один з цих ендпоінтів — оновіться до Indie ($5/міс) або вище, або переключіться на JSON-еквіваленти (/v1/chart, /v1/synastry тощо) для аналогічного контенту без PDF-рендеру.

2026-02-19 — Авторизація через Google і GitHub (+2 ендпоінти)

Один акаунт на всю екосистему — користувач, який реєструвався на astroway.info або app.astroway.info, входить у developer console через ту саму пошту/SSO, бачить історію замовлень, кредити й API-ключі.

• GET /v1/auth/oauth/google/start?return=<path> — стартує Google OAuth-флоу.
• GET /v1/auth/oauth/github/start?return=<path> — стартує GitHub OAuth-флоу.

Callback завершується редиректом на /dashboard/oauth/callback#access_token=&refresh_token=&user= — далі дашборд персистить токени як після /v1/auth/login. Якщо email уже зареєстрований через звичайну форму та email_verified=true від провайдера — обліковий запис лінкується, новий не створюється.

2026-02-17 — Reports Pack ($99 / 500 000 кредитів) + white-label включено

Тариф для розробників PDF-репортів — 100 PDF/міс за $0.99 ефективно, з white-label за замовчуванням:

• Тариф reports_pack ($99/міс або $990/рік) дає 500 000 кредитів і 200 запитів/хв.
• Доступ обмежений до /reports/* (12 типів PDF: natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot) + /whitelabel/* (індивідуальний логотип + кольори + домен). Все інше повертає 402 PLAN_PACK_MISMATCH (upgrade_to: pro).
• White-label включено як стандарт — не потрібен апгрейд до Enterprise для брендованих PDF.
• Перевитрата $3 / 10 000 кредитів (як Pro), перемикач обмеження витрат доступний.
• 21 локалізація PDF, формат A4, доставка через signed-URL CDN (TTL 24 год).

API plan enum тепер: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack. Новий WC slug: astroway-api-reports-pack.

2026-02-15 — Крос-школа: Jaimini yogas + Lal Kitab та KP doshas (+17 ендпоінтів)

Сімнадцять ендпоінтів — закривають вертикаль крос-школи для йог та дош.

• Jaimini Yogas (5) — /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Базуються на chara karakas (AK / Amk / PK).
• Lal Kitab dosha varianti (6) — /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. LK-специфічні відмінення та upayas.
• KP dosha varianti (6) — /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. BPHS-правила + KP sub-lord chain. Sade Sati — transit-aware (потребує targetDate).

Sources: Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI. Pricing: TIER_3 (50 кредитів).

2026-02-13 — Vedic Pack ($19 / 100 000 кредитів)

Окремий тариф для Vedic-астрології — 165 ендпоінтів за ціною Starter:

• Тариф vedic_pack ($19/міс або $190/рік) дає 100 000 кредитів і 100 запитів/хв.
• Доступ обмежений до Vedic namespaces (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Всі інші ендпоінти повертають 402 PLAN_PACK_MISMATCH.
• Покриття: 16 vargas D1-D60, panchang (7), shadbala (7), yogas (7), doshas (7), compatibility ashtakoot (6), muhurat (12 категорій), 8 систем dasha × 5 рівнів (40), KP, Lal Kitab, Jaimini.
• 2.5-5× більше карт за ту ж ціну, що Prokerala Ruby (~5K kundlis/міс vs їх 1-2K).

API plan enum тепер: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. Новий WC slug: astroway-api-vedic-pack.

2026-02-09 — Lal Kitab: повний пакет (+12 ендпоінтів)

Дванадцять ендпоінтів North-Indian Vedic школи на основі anonymous Urdu MSS 1939-1952. Ціла школа — YELLOW (intrinsic — single-school з розходженнями між modern авторами).

• /vedic/lal-kitab/teva — fixed-house chart (house = sign).
• /vedic/lal-kitab/lal-kundali — 12-house grid layout.
• /vedic/lal-kitab/kismat + /prosperity — fortune & dhana yoga scoring.
• /vedic/lal-kitab/dasha (35y) + /varshphal + /life-graph — timing.
• /vedic/lal-kitab/debts — 6 Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) detection + remedy.
• /vedic/lal-kitab/remedies — per-planet upayas (день / mantra / donation).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

Disclaimer surfaced у responses. Sources: K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Esoteric Pack ($9 / 200 000 кредитів)

Новий додатковий тариф для розробників езотерики/дивінації — 180 ендпоінтів за $9/міс:

• Тариф esoteric_pack ($9/міс або $90/рік) дає 200 000 кредитів і 60 запитів/хв.
• Доступ обмежений до просторів esoteric/divination (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Усі інші ендпоінти повертають 402 PLAN_PACK_MISMATCH.
• Не комбінується з іншими тарифами на одному ключі — це окреме розширення за аналогією з HD Pack.

API plan enum тепер: free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. Нові WC slug-и: astroway-api-esoteric-pack (місячна + річна варіації). Якщо ви створювали ключі через /v1/keys без явного plan — нічого не змінюється.

2026-02-02 — BaZi + Zi Wei Dou Shu (+17 ендпоінтів)

Третя китайська категорія, після Chinese Zodiac + Feng Shui:

• BaZi (5) — /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. Year + month pillars канонічні, day + hour pillars відкладено до cross-verification з Hong Kong Observatory (різні джерела дають різні JD-якорі).
• 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 — palace meanings + 14 main stars list. Повний chart відкладено (потрібна спеціалізована lunar-month ephemeris).

API now exposes 505 endpoints — паритет з ширшим конкурентом (Astrology-API.io).

2026-01-30 — Wellness (+9 ендпоінтів)

Дев’ять wellness-ендпоінтів — медична астрологія + дієта + йога + кристали тощо. Educational use only — not medical advice, дисклеймер у кожній відповіді.

• POST /v1/wellness/medical-astrology — body-rulership за традиційним Melothesia.
• POST /v1/wellness/diet — їжа за елементом (focus / emphasize / avoid).
• POST /v1/wellness/yoga — фокус + асани + пранаяма за знаком.
• POST /v1/wellness/exercise — інтенсивність + recommended/avoid за елементом.
• POST /v1/wellness/mental-health — element-profile дзеркала + dominantElement + сильні/слабкі сторони + coping.
• POST /v1/wellness/sleep-cycles — поради сну по фазах Місяця.
• POST /v1/wellness/herbs — трави за планетарним правителем знака (Culpeper 1653).
• POST /v1/wellness/crystals — кристали за знаком + інтенції.
• POST /v1/wellness/cycle — age-based wellness milestones (Saturn return, Uranus opposition, …).

Sources: Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Tier — 2 кредити (cycle = 1 кредит).

2026-01-27 — Mayan calendars (+8 ендпоінтів)

Майянський блок: класичний Tzolkin + Haab + Long Count + Calendar Round + Lord of the Night, плюс Dreamspell (модерн Argüelles 1990).

• POST /v1/mayan/tzolkin — 260-денний sacred calendar (число 1-13 + ім’я з 20).
• POST /v1/mayan/haab — 365-денний civil calendar (18 місяців × 20 + 5-денний Wayeb).
• POST /v1/mayan/long-count — 5-place позиційна нотація baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round — комбінований Tzolkin+Haab (52-річний цикл).
• POST /v1/mayan/lord-of-night — 9-денний цикл (G1-G9).
• POST /v1/mayan/full — все класичне в одному виклику.
• POST /v1/mayan/compatibility — сумісність пари за tone/name/element/direction.
• POST /v1/mayan/dreamspell — модерн Argüelles (kin 1-260, tone × seal).

Source: Goodman-Martínez-Thompson correlation (Thompson 1935 + Lounsbury 1976). Validation anchor: 2012-12-21 = Long Count 13.0.0.0.0 ✓ (Bak’tun rollover).

2026-01-23 — Sthira + Shoola Dasha (+10 ендпоінтів)

Дві Jaimini-школи rasi-dasha з повним cascade (maha, antar, pratyantar, sookshma, prana):

• Sthira — seed = знак Brahma planet, MD forward 12 знаків (7y movable / 8y fixed / 9y dual).
• Shoola — seed = stronger_rasi(asc, asc+6), MD forward 12×9y, опція antardasaSeedOption ∈ 3.

Закриває набір 10 dasha-шкіл × 5 рівнів = 50 ендпоінтів. Sources: BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

2026-01-19 — Pet + Business + Financial (+36 ендпоінтів)

Три категорії одним shipment:

• 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: entertainment only — not vet care.
• 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: strategic ideation, не правова/податкова порада.
• 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 у кожній відповіді.

Tier — 2 кредити (Financial market-timing/wealth-cycle = 3 кредити).

2026-01-16 — Jaimini analysis suite (+10 ендпоінтів)

Десять Jaimini-аналітичних ендпоінтів — chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK у D9), running dasha summary, basic Jaimini yogas.

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

2026-01-09 — Status page + AI-агенти + дефолтний base URL

• Публічна status page: https://api.astroway.info/status — uptime, latency p50/p95/p99, кешовано 60s.
• llms.txt for AI agents: https://api.astroway.info/llms.txt — структуровані інструкції для Claude / ChatGPT / Perplexity Code agents.
• Дефолтний base URL у документації, MCP server, SDKs, Postman collection — api.astroway.info/v1 (з 301 редіректом зі старого api-calc.astroway.info).

2025-12-30 — Tribhagi, Shatabdika, Shodashottari Dashas (+15 ендпоінтів)

Три nakshatra-dasha системи з full cascade:

• Tribhagi — 1/3-scale Vimshottari (40-year cycle).
• Shatabdika — 100-year cycle, 7 планет (без shadow).
• Shodashottari — 116-year cycle, 8 планет (без Rahu).

Sources: BPHS Adhyaya 46.

2025-12-25 — Кредитні плани: 5-tier rebalance + Free 5K → 10K

Перекалібровано кредитні tiers після 18-competitor audit. Free план тепер дає 10 000 кредитів на місяць (було 5 000). Проценти витрат для типових use-cases (натальна карта + 7 транзитів) знижено на ~22%. Жодних breaking-змін у API — лише економіка.

2025-12-17 — Chinese Zodiac + Feng Shui Kua (+8 ендпоінтів)

Перший блок китайської астрології, базовий шар (BaZi + Zi Wei Dou Shu — далі):

• POST /v1/chinese/zodiac/animal — тварина року + повний pillar (Geng-Wu, Wood-yang, тощо).
• POST /v1/chinese/zodiac/element — фіксований + циклічний елемент Wu Xing з yin/yang.
• POST /v1/chinese/zodiac/inner-animal — внутрішня тварина (бранч місяця).
• POST /v1/chinese/zodiac/secret-animal — таємна тварина (бранч години — потрібен time).
• POST /v1/chinese/zodiac/compatibility — сумісність пари за San He трина / Liu Chong конфлікт-парами.
• POST /v1/chinese/feng-shui/kua — персональне Kua-число + East/West-group.
• POST /v1/chinese/feng-shui/lucky-directions — 4 щасливі + 4 нещасливі компасні напрямки.
• POST /v1/chinese/feng-shui/bagua — Bagua-карта 9 життєвих сфер з елементами + кольорами.

Source: 60-jiazi canonical + L. Skinner Living Earth Manual (1976) + Lillian Too. Pricing tier — 2 кредити за виклик. Lichun cutoff = Feb 4 (точність ±1 день для 1900–2100).

2025-12-09 — Quality pass: 24 bug fixes у Vedic категоріях

Фіксація 24 розрахункових багів через 6 паралельних deep-research-агентів. Найкритичніші: Mangal dosha cancellation (own/exalted Mars cancels per BPHS), Pitru dosha trigger (Sun-Saturn vs Sun-Rahu), composite Davison ARMC drift, ACG meridian-line accuracy. Snapshot-тестів додано: 47.

2025-12-02 — Vedic Compatibility + Muhurat (+18 ендпоінтів)

• Compatibility (6) — Ashta-Koota matching (Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi) + Mangal dosha compat + Bhrigu summary.
• Muhurat (12) — електив для марriage, business, journey, education, surgery, наречений, mahurta-types (abhijit, vijaya, amrit, brahma).

Sources: BPHS + Muhurta Chintamani.

2025-11-29 — KP (Krishnamurti Paddhati): повний пакет (+10 ендпоінтів)

Десять ендпоінтів канонічної KP-школи (K.S. Krishnamurti 1971).

• /vedic/kp/{cusps, sub-lords, planet-cuspal-position} — Placidus cusps + 4-level sub-lord chain (sign / star / sub / sub-sub).
• /vedic/kp/ruling-planets — Day/Hora + Asc + Moon chain, deduplicated.
• /vedic/kp/horary — KP horary number 1..249 → ASC longitude lookup.
• /vedic/kp/significators — primary / secondary / tertiary per planet.
• /vedic/kp/sub-sub-lord — chain at arbitrary sidereal longitude.
• /vedic/kp/asc-sub — Ascendant sub-lord.
• /vedic/kp/fortuna — Part of Fortune (day/night) + KP chain.
• /vedic/kp/transit-kp — current-moment positions + KP chain.

Алгоритм: Vimshottari proportional sub-divisions (27 stars × 9 sub-lords). Sources: K.S. Krishnamurti Reader I-VI (1971-77).

2025-11-22 — Vimshottari + Yogini + Ashtottari + Kalachakra Dashas (+20 ендпоінтів)

Чотири класичні Vedic dasha-системи з повним cascade (maha, antar, pratyantar, sookshma, prana):

• Vimshottari — 120-year cycle, 9 планет.
• Yogini — 36-year cycle, 8 yoginis.
• Ashtottari — 108-year cycle, 8 планет (без Ketu), Ardradi tradition.
• Kalachakra — sign-based dasha, paramayu варіює per pada (100/85/83/86).

Sources: BPHS Adhyaya 46 + Saravali. Cross-validated проти PyJHora 7.02.

2025-11-08 — Chara Dasha (Jaimini K.N. Rao) (+5 ендпоінтів)

Rasi-dasha школи Jaimini у варіанті K.N. Rao (1995). Direction = forward для рухомих/двоїстих знаків лагни, reverse — для фіксованих. Co-lord rule для Скорпіона (Mars+Ketu) і Водолія (Saturn+Rahu).

2025-10-25 — MCP-сервер + AI gateway

• MCP-сервер @astroway/mcp — Model Context Protocol для Claude Desktop, Cursor, Cody. Кожен ендпоінт API доступний як MCP tool.
• AI gateway — окремий приватний микросервіс ai.astroway.info обробляє LLM-запити з провайдерною ланкою (Gemini Flash → Groq Llama → OpenRouter → Cerebras → SambaNova → Mistral).
• TypeScript SDK очікується окремим релізом — поки що використовуйте OpenAPI codegen за https://api.astroway.info/v1/openapi.json (openapi-typescript / openapi-fetch дають типизованого клієнта з 612 типизованих request/response пар).

2025-10-08 — Vedic Yogas + Doshas Parashara (+14 ендпоінтів)

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

Sources: BPHS Adhyayas 36-39, Phaladeepika.

2025-08-10 — Vedic Vargas D1-D60 + Panchang + Shadbala (+31 ендпоінт)

• 16 Vargas D1-D60 (16) — від Rasi (D1) до Shashtiamsa (D60), per BPHS Adhyaya 7.
• Panchang (8) — tithi, vara, nakshatra, yoga, karana + sunrise/sunset, abhijit, rahu kaal.
• Shadbala (7) — 6 sources of strength per planet + composite (Sthana, Dig, Kala, Cheshta, Naisargika, Drig).

2025-05-18 — Esoteric dictionaries + Crystal/Angel/Dream (+30 ендпоінтів)

Розширення reference-словників: 15 esoteric понять (chakras, koshas, tattvas, gunas) + 15 crystal/angel/dream lookup tables. Cached на edge (Cloudflare R2).

2025-03-12 — Reference glossary + Tarot Lenormand (+24 ендпоінти)

• Reference (14) — словники signs, planets, houses, aspects, nakshatras, fixed stars, Sabian symbols.
• Tarot Lenormand (10) — 36-card system: single, 3-card, 9-card, Grand Tableau, by-question.

2024-11-15 — Tarot Marseille (+20 ендпоінтів)

20 ендпоінтів Marseille deck: spreads (single, 3-card, Cross, 5-card, Celtic Cross, year-ahead), card meanings, reversed mode, by-question. Sources: Camoin / Jodorowsky public references.

2024-08-25 — Numerology — повний пакет: Pythagorean + Chaldean + Kabbalistic + Vedic (+40 ендпоінтів)

Чотири нумерологічні системи × 10 ендпоінтів кожна: life path, expression, soul urge, personality, birthday, maturity, current personal year/month/day, name compatibility.

Sources: Pythagorean (Cheiro 1908), Chaldean (Cheiro), Kabbalistic Hebrew gematria, Vedic Chaldean Indian.

2024-05-08 — Tarot Rider-Waite-Smith (+35 ендпоінтів)

35 ендпоінтів RWS deck: усі канонічні spreads (single, 3-card, Celtic Cross, year-ahead, relationship, 5-card horseshoe, 7-card ellipse, decision, situation, monthly), card meanings (upright + reversed), by-question, daily card, deck shuffle.

Sources: Smith images PD since 2021, Waite “Pictorial Key” 1909 PD.

2024-02-20 — AI horoscope generation + interpretations (+12 ендпоінтів)

Генерація natural-language інтерпретацій:

• /horoscope/{daily, weekly, monthly} — текстові гороскопи.
• /interpret/{natal, transit, synastry, compatibility} — детальні інтерпретації.

Провайдерна ланцюжок: GPT-4 → Anthropic Claude → fallback Groq.

2023-11-28 — Destiny Matrix (Ladini) (+1 ендпоінт)

/destiny-matrix/ladini — система Natalia Ladini (Russian/CIS market). Single-author method з явним disclaimer.

2023-09-20 — Aspects timeline + harmonics + cyclic index (+12 ендпоінтів)

Розширений aspect-аналіз:

• /aspect-timeline — точні моменти aspects на N днів вперед.
• /harmonics/{2..12} — гармонійні карти.
• /cyclic-index — Андре Барбо’s cyclic index of social tensions.
• /sabian-symbols — Marc Edmund Jones 360 symbols.

2023-05-10 — Astrocartography + Local Space + Geodetic (+18 ендпоінтів)

Geo-астрологія:

• /acg + /acg-zones — Astrocartography ліній планет.
• /local-space — Local Space horizon.
• /parans — параны (Bernadette Brady).
• /relocation — relocation chart.
• /zenith + /horizon + /geodetic — додаткові geo-engines.
• /ccg-analysis — CCG/CMG детальна geo-аналіз.

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

2023-02-15 — Human Design module (+12 ендпоінтів)

Повний Human Design engine:

• /human-design — bodygraph (gates, channels, centers, type, profile, authority, strategy, environment, perspective).
• /hd/incarnation-cross — incarnation cross + 4 gates.
• /hd/{channels, gates, profiles, definition, authority, strategy, environment, perspective, mental-projector, etc}.

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

2022-08-20 — Серверні synastry + composite

Реляційна астрологія (synastry, composite, Davison) реалізована на сервері. Першими доступні через /v1/synastry, /v1/composite, /v1/davison. Маркер розширення до релаційного аналізу.

Валідовано проти Solar Fire / Astrodienst — drift у межах похибки методу (≤0.5″ на середньостатистичному обчисленні).

2022-07-28 — Synastry, composite, Davison + group synastry (+5 ендпоінтів)

• /synastry — relationship comparison з aspects matrix.
• /composite — Robert Hand midpoint composite.
• /davison — Ronald Davison time-place composite.
• /group-synastry — multi-person (3+) synastry матриця.

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

2022-04-15 — app.astroway.info SPA — споживчий продукт live

Запущено app.astroway.info — SPA на React/TypeScript, що звертається до бекенда через /v1/*. Користувацькі акаунти, збережені карти, обране. Маркер переходу від тільки-сайту до повноцінного продукту.

Цей же бекенд згодом стає базою публічного API.

2022-03-18 — Essential dignities + receptions + almuten + arabic parts (+13 ендпоінтів)

Класична астрологія:

• /essential-dignities — domicile, exaltation, triplicity, terms, faces.
• /receptions — mutual reception detection.
• /almuten — Almuten Figuris (chart ruler).
• /arabic-parts — Lots of Fortune, Spirit, Eros, Necessity та інші 30+ Hellenistic lots.
• /hyleg — hyleg + alcocoden.
• /algol-minimum + /fixed-stars — fixed stars.

Sources: Lilly Christian Astrology + Brennan Hellenistic Astrology.

2021-08-10 — Transit calendar + forecast calendar + phase return (+10 ендпоінтів)

• /transit-calendar — точні моменти transits на 6/12 місяців вперед.
• /forecast-calendar — щомісячні forecasts.
• /phase-return — solar return, lunar return, Saturn return, Jupiter return.
• /eclipse-analysis — eclipses у contextі natal chart.

2021-04-05 — Aspects calculation + house systems expansion (+8 ендпоінтів)

• /aspects — повна aspects matrix з orb tables (Ptolemy, modern, asteroid).
• /coalescent — coalescent points.
• /disposition-chains — planet rulership chains.
• House systems expansion: Placidus, Koch, Equal, Whole, Campanus, Regiomontanus, Topocentric, Porphyry, Alcabitius, Morinus.

2020-07-10 — Aspects matrix + класичні аспекти

Стабілізовано суть calculation suite. /v1/aspects готовий: підтримка conjunction, opposition, square, trine, sextile з птолемеївськими орбами. Фундамент для всієї подальшої аналітики (transits, synastry, returns).

WASM-збірка Swiss Ephemeris остаточно інтегрована — ~5x швидше за раніше використовувану аналітичну модель.

2020-06-15 — Daily/weekly horoscope text (+4 ендпоінти)

• /horoscope/daily/{sign} — щоденний гороскоп для кожного знаку.
• /horoscope/weekly + /horoscope/monthly — тижневі / місячні.
• /sun-signs — sun-sign meanings.

Текст генерується manual editorial team (LLM-augmented texts came later у 2024).

2020-03-20 — Synastry beta + ephemeris extras (+5 ендпоінтів)

• /synastry-beta — initial synastry (повний релиз 2022).
• /ephemeris/{planets, asteroids, lunar-nodes} — historical 1900-2100.
• /extra — fixed stars, Black Moon Lilith, Chiron.

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

Опубліковано внутрішню специфікацію OpenAPI 2.0. Перший namespace /v1/*. Аутентифікація через X-Api-Key-заголовок. Rate-limiting infrastructure готова.

Internal milestone — публічний API запуститься пізніше, але контракт стабільний з цього моменту.

2019-12-15 — Internal /chart calculation engine

Перша серверна реалізація /chart (приватна). Placidus-доми, sidereal-офсети, обчислення планет, фіксованих зір. Тестування проти Astro.com baseline.

Повністю Node.js — від попередньої PHP-only логіки відмовляємось остаточно.

2019-09-25 — Initial release

Перший публічний випуск AstroWay Astrology API. Базовий функціонал:

• /chart — натальна карта (планети, доми, ascendant, MC).
• /transit — поточні транзитні позиції.
• /aspects — основні aspects (conjunctions, oppositions, squares, trines, sextiles).
• /horoscope — щоденний гороскоп (за sun sign).
• /ephemeris — ефемериди для будь-якої дати.
• /health — health check.

OpenAPI 2.0 specification, REST/JSON, X-Api-Key authentication. Backend on Swiss Ephemeris. Free tier — 1000 requests / month.

2019-09-01 — Інтеграція Swiss Ephemeris — фундамент

Бібліотеку Swiss Ephemeris 2.x інтегровано в бекенд astroway.info. Sub-arcsecond точність планетарних позицій, лунарних вузлів, астероїдів у межах 1900–2100.

Усі наступні розрахункові ендпоінти спираються на цей шар. Та сама бібліотека, що в Solar Fire, Kepler, Astro Gold, Astrodienst.