FAQ answers

Generalități

Ce este AstroWay API?

API HTTP profesionist pentru calcule astrologice. 714 de endpoint-uri bazate pe Swiss Ephemeris (WASM): hărți natale, sinastrie, progresii, direcții, tranzite, Human Design, astrocartografie, rectificare, interpretări AI. Toate calculele sunt efectuate pe server — niciun fel de dependențe pe partea clientului.

Pentru cine este acest API?

Pentru dezvoltatori care construiesc aplicații astrologice (web/mobil), companii AI care adaugă funcții astrologice, astrologi profesioniști cu scripturi și cercetători care au nevoie de acces programatic la calcule.

Care este precizia calculelor?

Swiss Ephemeris oferă o precizie a pozițiilor planetare de până la ±1 secundă de arc, iar a cuspidelor caselor până la ±1 minut de arc. Rezultatele sunt verificate împotriva Astrodienst (Astro.com), Solar Fire, Zet 9 și Kepler. Abatere sub secundă de arc comparativ cu ephemeris NASA JPL și NASA 5-Millennium Eclipse Catalog.

Cum se compară AstroWay cu Astro.com sau Solar Fire?

Motorul este identic cu cel al Swiss Ephemeris — același folosit de Solar Fire ($495 licență), Kepler ($995), Astro Gold ($29.99/lună) și Astrodienst (Astro.com). Validat împotriva ephemeris NASA JPL și a referinței oficiale swetest de la Astrodienst. Abatere sub secundă de arc (≤0.1″) pentru pozițiile planetare și ≤1 minut pentru eclipse. Diferența: AstroWay este un API REST de la $5/lună în loc de o licență one-time sau GUI desktop.

Ce sisteme de case sunt suportate?

15 sisteme: Placidus (implicit), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC și Equal de la MC. Transmite codul corespunzător în parametrul houseSystem.

Credite și plată

Cum funcționează sistemul de credite?

Fiecare endpoint are un cost fix în credite (de la 10 la 500), în funcție de complexitatea calculului. Un lookup simplu costă 10 credite, o hartă natală 20, sinastrie 50, rectificare 500. Tabelul complet este disponibil pe pagina Prețuri.

Există un tarif gratuit?

Da. Planul Free oferă 10.000 de credite/lună, 10 req/min. Nu este necesară introducerea unui card. Este suficient pentru a evalua produsul și pentru prototipare.

Ce se întâmplă când creditele se epuizează?

Pe planul Free, cererile sunt blocate până luna următoare (429 CREDITS_EXHAUSTED). Pe planurile Indie/Starter/Pro/Business, se aplică overage: $5 / $3 / $2 pentru fiecare 10.000 de credite suplimentare.

Sunt cererile identice memorate în cache?

Da. Un input identic returnat în decurs de 5 minute este preluat din cache fără a consuma credite. Acest lucru este confirmat de antetul X-Cache: HIT.

Pot cumpăra credite fără abonament?

Momentan nu. Abonamentul oferă un buget previzibil și o limită de rate mai bună. Un plan pay-as-you-go este în planificare.

Tehnic

Ce SDK-uri sunt disponibile?

• Server MCP ✅ lansat: npx -y @astroway/mcp — expune toate cele 714+ de endpoint-uri ca instrumente pentru Claude $1, Cursor, GPT și alți agenți AI compatibili MCP
• SDK TypeScript ✅ lansat: npm install @astroway/sdk — tipuri + autocomplete cu OpenAPI 3.1, retry + idempotency, erori de tip Stainless
• SDK Python ✅ lansat: pip install astroway — sync Astroway + async AsyncAstroway, bazat pe httpx, tipizat conform PEP 561
• SDK PHP ✅ lansat: composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, middleware pentru retry
• Go / Ruby / Rust 📋 planificat — înscrie-te pentru notificări prin email pe pagina fiecărui SDK (/sdk/<limbaj>/)

Contractul API este standard REST + JSON, astfel încât orice client HTTP funcționează fără SDK. Colecția Postman și specificația OpenAPI 3.1 sunt disponibile public.

Există un mod sandbox?

Da. Cheile aw_test_* nu consumă credite și returnează aceleași rezultate. Ideal pentru dezvoltare și testare.

Care este limita de rate?

Depinde de plan: Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1.000 req/min. La depășire, primesti 429 cu antetul Retry-After.

Este suportat zodiacul sideral?

Da. Transmite "zodiacType": "sidereal" și opțional "ayanamsaId" (implicit este Lahiri). Funcționează cu toate endpoint-urile.

Ce sunt endpoint-urile Human Design?

12 de endpoint-uri pentru calculul Human Design: tip, strategie, autoritate, profil, definiție, cruce de incarnare, canale, centre, Dream Rave, Profil Hologenetic, Penta (dinamică de grup), sensibilitate temporală. Cel mai profund acoperire HD dintre API-urile comerciale.

Securitate și confidențialitate

Sunt stocate datele despre cereri?

API-ul funcționează stateless — datele despre dată/oră/coordonate de naștere nu sunt stocate după procesarea cererii. Sunt logate doar metadate: key_id, endpoint, timestamp, latență, credite. Nicio dată personală.

API-ul este conform GDPR?

Da. Datele nu sunt stocate. Pentru utilizatorii din UE: niciun procesare a PII, niciun profiling, niciun cookie. Cheia API este legată de cont, nu de utilizatorul final.

Sunt interpretările AI sigure?

Endpoint-urile AI (/interpret/*, /horoscope/*) au mecanisme integrate de siguranță: interzicerea sfaturilor medicale, juridice sau financiare. Fiecare răspuns include un disclaimer. Jurnalul complet de audit este disponibil pentru conformitatea enterprise.

Suport

Cum pot obține ajutor?

Depinde de plan: Free — comunitate, Indie — email (48 ore), Starter — email (24 ore), Pro — email (4 ore), Business — email + Slack (1 oră), Enterprise — manager dedicat pe Slack. Contactează-ne pe pagina Contacte.

Există SLA?

Indie: 99% uptime. Starter și Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: SLA personalizat cu garanții financiare.