Lansarea API-ului AstroWay: stivă completă de calcule astrologice cu precizia Swiss Ephemeris

Astăzi anunțăm AstroWay API - un backend de calcul pentru dezvoltatorii care creează aplicații astrologice, produse de horoscop, funcții de compatibilitate pentru dating și agenți AI care trebuie să raționeze despre hărțile natale.

În acest articol - ce se află de fapt în interiorul API-ului, ce decizii neobișnuite am luat, ce am lăsat în mod conștient deoparte și cum am ajuns aici. Fără detalii inutile.

🕓 Înregistrare din 2026-04-22, actualizată 2026-05-09. Unele cifre sunt depășite. Starea actuală: 865 endpoint-uri (nu 87 la momentul lansării), 888 teste snapshot CI (nu 183), serverul MCP @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk sunt acum toate disponibile pe registre publice. Statutul actualizat - în /faq și changelog.

Un API REST bazat pe Swiss Ephemeris - acum și cu interpretări AI peste calcule reale. Același motor pe care astrologii profesioniști îl folosesc de peste 30 de ani în Solar Fire, Kepler, Astro Gold și Janus - precizie până la o fracțiune de secundă de arc, verificată cu efemerida NASA JPL și referința oficială swetest de la Astrodienst (Astro.com).

Cifre:

• 865 endpoint-uri: astrologie natală occidentală, sinastrie, tranzite, progresii, direcții, reveniri, armonici, stele fixe, puncte arabe, astrocartografie plus un set complet de Human Design
• 183 teste snapshot în CI împotriva rezultatelor reale swetest CGI și a catalogului de eclipse NASA - rulate la fiecare PR
• p50 < 100 ms, p95 < 500 ms pentru endpoint-urile de calcul tipice
• Server MCP @astroway/mcp + trei SDK-uri pe registre publice: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - același API în trei limbaje
• Server MCP: @astroway/mcp - oferă API-ul ca instrumente pentru Claude, GPT, Cursor și alți agenți LLM
• Tarife bazate pe credite: plan gratuit (10.000 credite / lună, fără card), plătite - de la 5 $ / lună

Documentație completă: api.astroway.info/docs/api/. Statut live: api.astroway.info/status.

Acum trei ani am început să construim aplicații astrologice pentru consumatori. Stratul de calcul s-a dovedit a fi cea mai complexă parte - semnificativ mai complexă decât UI-ul sau conținutul. Serviciile existente fie:

1. Aveau o acoperire superficială (10–30 de endpoint-uri, predominant doar natal)
2. Erau scumpe la scară (0,02–0,10 $ per cerere fără reduceri de volum)
3. Foloseau motoare închise, a căror precizie nu putea fi verificată
4. Se concentrau pe astrologia vedică, iar pe cea occidentală o prezentau ca secundară

Așa că am integrat Swiss Ephemeris pe cont propriu și am scris propriul nostru strat de calcul - inițial pentru produsul de consum app.astroway.info, apoi pentru site-ul de marketing astroway.info, care oferă horoscoape zilnice sutelor de mii de vizitatori pe lună.

După trei ani de funcționare a acestui cod în producție, am ajuns la două concluzii:

1. Același motor de calcul ar trebui să fie disponibil altor dezvoltatori: nu pentru că nu l-ar putea scrie singuri, ci pentru că stiva bibliotecă + caching + CI pentru precizie - reprezintă jumătate de an de muncă pe care nimeni nu ar trebui să o repete.
2. Acoperirea noastră Human Design (12 endpoint-uri: hartă, tip, autoritate, profil, porți, canale, circuite, activări planetare, cruce de încarnare, definiție) - este cu adevărat unică. Niciun concurent nu oferă un stack HD complet prin API.

Aceasta este lansarea.

Avem /nakshatras, /ashtakavarga și endpoint-uri pentru hărți divizionare, dar nu avem Dasha, Panchang, Ashtakoota, KP. Motivul: în astrologia vedică există divergențe nerezolvate între școli (războaie de ayanamsha, dispute despre cuspidele KP, alegerea școlii de dasha). O parte vedică făcută în grabă împotriva Prokerala și VedicAstroAPI ar fi primit doar critici.

Decizia este fixă: pachetul vedic - o fază 3 separată, după ce va exista o cerere stabilă pentru astrologia occidentală și va fi timp să validăm împotriva Jagannatha Hora și Parashara’s Light. Mai bine să nu lansăm deloc, decât să lansăm prost.

Un apel /chart costă de aproximativ 50 de ori mai puțin în calcule decât un /forecast-calendar de 365 de zile. Un preț fix per cerere ar fi exclus utilizatorii ocazionali sau i-ar fi subvenționat pe cei intensivi. Creditele mapează costul la munca reală - vezi tabelul de endpoint-uri pe pagina de prețuri.

Răspunsurile pe planul gratuit conțin câmpul _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Acest lucru nu ne costă nimic, iar utilizatorilor gratuiti le oferă un mic motiv să facă upgrade. Pe planul Hobby+, se elimină din setările cheii. Am împrumutat modelul de la Zapier și RevenueCat.

/rectification (selectarea orei de naștere pe baza evenimentelor de viață prin căutare likelihood-grid) - este costisitor din punct de vedere computațional: un singur apel durează 10–60 de secunde și efectuează zeci de mii de calcule intermediare Swiss Ephemeris. L-am limitat la planul Pro (59 $ / lună) și am stabilit un preț mare în credite, deoarece abuzul ar fi blocat infrastructura comună pentru toți ceilalți.

Endpoint-urile /interpret/* funcționează prin gateway-ul nostru AI privat cu failover automat între mai multe modele. Nu te blocăm în propriile noastre prompturi - fiecare răspuns cu interpretare conține calculele originale, astfel încât poți să-ți reprogramezi propriul LLM dacă vocea noastră nu ți se potrivește. Prompturile și ieșirile complete le înregistrăm într-un tabel de audit pentru conformitatea B2B (stocare 90 de zile).

• Pachetul vedic: faza 3, după primele confirmări ale cererii (vezi mai sus)
• Webhook-uri la atingerea pragurilor: implementate, dar UI-ul este brut; lucrăm la el
• Widget-uri publice (<script src="api.astroway.info/widget/natal.js">) - faza 7
• Plugin pentru site-ul principal de marketing: proiect separat, planificat în cadrul ecosistemului astroway.info

1. Citește documentația dacă vrei să înțelegi “de ce”: api.astroway.info/overview
2. Start rapid în 5 minute cu cod: Astrology API Quick Start
3. Tarife, inclusiv tabelul de credite per endpoint: api.astroway.info/pricing
4. Înregistrează-te: gratuit, fără card: api.astroway.info/dashboard/sign-up

Dacă construiești ceva pe API - sau găsești un bug, sau vrei un endpoint pe care nu-l avem încă - scrie-ne. Preferăm să auzim de la o sută de dezvoltatori care cer ceva, decât să lansăm funcționalități pe care nimeni nu le folosește.

Întrebări, solicitări, cazuri limită ciudate: hello@astroway.info.

Roadmap-ul este public - PRODUCT-PLAN.md - ce s-a făcut, ce urmează, ce a fost amânat și de ce.

Bun venit.