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

Astăzi lansăm AstroWay API — un backend computațional pentru dezvoltatorii care creează aplicații astrologice, produse de horoscop, funcții de compatibilitate pentru dating și agenți AI care au nevoie să gândească despre hărți de naștere.

În acest articol — ce se află într-adevăr în API, ce soluții neobișnuite am adoptat, ce am lăsat intenționat în afara parantezelor și cum am ajuns aici. Fără apă.

🕓 Înregistrare din 2026-04-22, actualizată 2026-05-09. Unele cifre sunt învechite. Starea actuală: 723 endpointuri (și nu 87 la lansare), 818 teste CI snapshot (și nu 183), serverul MCP @astroway/mcp + SDK-ul TypeScript @astroway/sdk + SDK-ul Python astroway + SDK-ul PHP astroway/sdk acum toate trăiesc pe registre publice. Starea actuală — în /faq și changelog.

API REST bazat pe Swiss Ephemeris (LGPL), compilat în WASM și implementat ca serviciu Node.js — acum și cu interpretări AI (lanț de failover GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) deasupra calculelor reale. Același motor pe care îl utilizează astrologii profesioniști de peste 30 de ani în Solar Fire, Kepler, Astro Gold și Janus — precizie până la o fracțiune de secundă unghiulară, verificată cu ephemerida NASA JPL și referința oficială swetest de la Astrodienst (Astro.com).

Cifrele:

• 723 endpoint — astrologie natală occidentală, sinastrie, tranzite, progresii, direcții, reîntoarceri, armonici, stele fixe, puncte arabe, astrocartografie plus setul complet de Human Design
• 183 teste snapshot în CI împotriva ieșirii reale swetest CGI și catalogului de eclipse NASA — rulează la fiecare PR
• p50 < 100 ms, p95 < 500 ms pentru endpointurile de calcul tipice
• Serverul MCP @astroway/mcp + trei SDK-uri pe registre publice: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — același API în trei limbi
• Serverul MCP: @astroway/mcp — oferă API-ul ca unelte pentru Claude, GPT, Cursor și alți agenți LLM
• Tarife bazate pe credite: plan gratuit (10 000 de credite / lună, fără card), planuri plătite — de la $5 / lună

Documentația completă: api.astroway.info/docs/api/. Starea actuală: 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 dificilă parte — mult mai dificilă decât UI sau conținut. Serviciile existente fie:

1. Aveau o acoperire superficială (10–30 de endpointuri, în principal doar natale)
2. Erau scumpe la scară ($0,02–$0,10 pe cerere fără reduceri în volum)
3. Utilizau motoare închise, ale căror precizie nu putea fi verificată
4. Se concentrau pe astrologia vedică, prezentând astrologia occidentală ca o a doua opțiune

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

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

1. Același motor de calcul trebuie să fie disponibil și altor dezvoltatori — nu pentru că nu ar putea să îl scrie singuri, ci pentru că stiva bibliotecă + WASM + caching + CI pentru precizie — este o jumătate de an de muncă, pe care nimeni nu ar trebui să o repete.
2. Acoperirea noastră Human Design (12 endpointuri — hartă, tip, autoritate, profil, porți, canale, contururi, activări planetare, crucea de întrupare, definiție) — este cu adevărat unică. Niciun competitor nu oferă un set complet de HD prin API.

Acesta este lansarea.

Avem /nakshatras, /ashtakavarga și endpointuri pentru hărți divisionale, dar nu avem Dasha, Panchang, Ashtakoota, KP. Motivul: în astrologia vedică există neînțelegeri nerezolvate între școli (războaie ayanamsha, dispute despre cuspide KP, alegerea școlii dasha). O parte vedică făcută pe grabă ar fi primit critici.

Decizia este fixată: pachetul vedic — o fază separată 3, după ce vom avea confirmări inițiale ale cererii (vezi mai sus).

O singură chemare /chart costă de aproximativ 50 de ori mai puțin calcul decât un /forecast-calendar pe 365 de zile. Un preț plat pe cerere sau ar fi exclus utilizatorii ușori, sau ar fi subvenționat utilizatorii grei. Creditele mapării costului la munca reală — vezi tabela pe endpointuri pe pagina de prețuri.

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

{
  "data": { ... },
  "_footer": "Powered by astroway.api — obțineți cheia dvs. la api.astroway.info"
}

Nu ne costă nimic, iar utilizatorilor noștri li se oferă un mic stimulent pentru a se actualiza. Pe planul Hobby+ se elimină în setările cheii. Am împrumutat modelul de la Zapier și RevenueCat.

/rectification (selectarea orei de naștere pe baza evenimentelor din viață prin căutarea gridului de probabilitate) — este scump din punct de vedere computațional: o singură chemare durează 10–60 de secunde și face zeci de mii de calcule intermediare Swiss Ephemeris. Am limitat-o la planul Pro ($59 / lună) și am stabilit un preț de credit mare, deoarece abuzul ar fi pus în pericol infrastructura comună pentru toți ceilalți.

Endpointurile /interpret/* sunt rutate prin poarta noastră privată AI, care rulează pe modelele de top de pe piață (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) cu failover automat. Nu vă închidem în prompturile noastre — fiecare răspuns cu interpretare conține calculele originale, astfel încât puteți să cereți din nou cu LLM-ul dvs. propriu, dacă vocea noastră nu vă place. Prompturile și ieșirile complete le logăm în tabela de audit pentru conformitatea B2B (stocare 90 de zile).

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

1. Citiți documentația dacă doriți să înțelegeți “de ce”: api.astroway.info/overview
2. Început rapid în 5 minute cu cod: Astrology API Quick Start
3. Prețuri, inclusiv tabela de credite pe endpoint: api.astroway.info/pricing
4. Înregistrați-vă — gratuit, fără card: api.astroway.info/dashboard/sign-up

Dacă construiți ceva pe API — sau găsiți o eroare, sau doriți un endpoint pe care nu îl avem — scrieți-ne. Ne place să auzim de la o sută de dezvoltatori care cer ceva, decât să lansăm funcții pe care nimeni nu le utilizează.

Întrebări, solicitări, cazuri edge 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.