FAQ answers

General

Ce este AstroWay API?

API HTTP profesional pentru calcule astrologice. 771 endpoint-uri bazate pe Swiss Ephemeris: hărți natale, sinastrie, progresii, direcții, transite, Human Design, astrocartografie, rectificare, interpretări AI. Toate calculele pe server - nicio dependență pe partea clientului.

Pentru cine este acest API?

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

Care este precizia calculelor?

Swiss Ephemeris asigură precizia pozițiilor planetare până la ±1 secundă de arc, a cuspidilor caselor - până la ±1 minut de arc. Rezultatele sunt verificate împotriva Astrodienst (Astro.com), Solar Fire, Zet 9 și Kepler. Derivata sub-arcsecond față de ephemeris-ul NASA JPL și catalogul de eclipse NASA 5-Millennium.

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

Același motor Swiss Ephemeris - același ca în Solar Fire (licență $495), Kepler ($995), Astro Gold ($29.99/lună) și Astrodienst (Astro.com). Validat împotriva ephemeris-ului NASA JPL și a referinței swetest oficială de la Astrodienst. Derivată sub-arcsecond (≤0.1″) pe pozițiile planetare, ≤1 minut pe eclipse. Diferența: AstroWay - REST API de la $5/lună în loc de licență unică sau interfață desktop GUI.

Sistemele de case care 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ți 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 calculelor. Căutare simplă - 10, hartă natală - 20, sinastrie - 50, rectificare - 500. Tabelul complet - pe pagina Tarife.

Există un plan gratuit?

Da. Planul Free oferă 10 000 de credite/lună, 10 cereri/minut. Fără introducerea cardului. Destul pentru evaluarea produsului și prototipare.

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

La Free - cererile sunt blocate până la luna următoare (429 CREDITS_EXHAUSTED). La Indie/Starter/Pro/Business - se activează overage: $5 / $3 / $2 pentru 10 000 de credite suplimentare.

Sunt cererile identice stocate în cache?

Da. Input identic în decurs de 5 minute se returnează din cache fără a se deduce credite. Se confirmă prin antetul X-Cache: HIT.

Se pot cumpăra credite fără abonament?

Deocamdată nu. Abonamentul oferă un buget predictibil și o rată limită mai bună. Planul Pay-as-you-go este planificat.

Tehnic

Care SDK-uri sunt disponibile?

• MCP server ✅ lansat: npx -y @astroway/mcp: expune toate 771+ endpoint-uri ca unelte pentru Claude Desktop, Cursor, GPT și alți agenți AI compatibili cu MCP
• TypeScript SDK ✅ lansat: npm install @astroway/sdk: tipuri + autocomplete din OpenAPI 3.1, retry + idempotency, erori de tip Stainless
• Python SDK ✅ lansat: pip install astroway: sincron Astroway + asincron AsyncAstroway, bazat pe httpx, PEP 561 tipizat
• PHP SDK ✅ lansat: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, middleware retry
• Go / Ruby / Rust 📋 planificat: abonează-te la notificare prin email pe pagina fiecărui SDK (/sdk/<language>/)

Contractul API - REST standard + JSON, deci orice client HTTP funcționează fără SDK. Colectia Postman și specificația OpenAPI 3.1 sunt disponibile public.

Există un mod sandbox?

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

Care este limita de rată?

Depinde de plan: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1 000 cereri/minut. La depășire - 429 cu antetul Retry-After.

Este suportat zodiacul sideral?

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

Care sunt endpoint-urile Human Design?

12 endpoint-uri pentru calculul Human Design: tip, strategie, autoritate, profil, definiție, cruce incarnațională, canale, centre, Dream Rave, Hologenetic Profile, Penta (dinamică de grup), sensibilitate temporală. Acoperirea HD cea mai profundă printre API-urile comerciale.

Securitate și confidențialitate

Sunt datele cererilor stocate?

API-ul funcționează fără stare - datele despre data/ori/n coordonatele nașterii nu sunt stocate după procesarea cererii. Se înregistrează doar metadatele: key_id, endpoint, timestamp, latență, credite. Fără date personale.

API-ul respectă cerințele GDPR?

Da. Datele nu sunt stocate. Pentru utilizatorii din UE: nicio procesare PII, nicio profilare, nicio cookies. Cheia API este legată de cont, nu de utilizatorul final.

Sunt interpretările AI sigure?

Endpoint-urile AI (/interpret/*, /horoscope/*) au gard de siguranță încorporat: interzicerea sfaturilor medicale, juridice, financiare. Fiecare răspuns include un disclaimer. Istoric complet de audit - pentru conformitate enterprise.

Suport

Cum să obții 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 în Slack. Contacte - 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.

Nume similare

API-ul AstroWay (astroway.info) este legat de abonamentul “Astroway” de la astroway.life?

Nu. astroway.info și api.astroway.info sunt companii separate, independente. Oferim API astrologic pentru dezvoltatori (api.astroway.info), aplicație pentru utilizatori finali (app.astroway.info) și consultanță astrologică. Nu avem nicio legătură cu abonamentul astrologic pentru consumatori, care este promovat și facturat sub numele “Astroway” prin astroway.life (scrisori de la no-reply@astroway.life, persoana “Celeste”, în extrasul bancar - “Astroway”). Operatorul acestui abonament este TrafficLeader OÜ (Estonia, și traffic-leader.com); procesatorul asociat SKYREAD.PRO este ABCMobile OÜ (Estonia). Se potrivește doar sunetul similar al numelui - sunt companii diferite.

Sunt taxat de “Astroway” - cum să anulez abonamentul și să primesc banii înapoi?

Dacă ești taxat pentru abonamentul “Astroway” (scrisori de la no-reply@astroway.life, în extrasul bancar - “Astroway”), aceasta este o altă companie, astroway.life, nu noi. Nu avem acces la contul tău sau la plățile din acest serviciu, deci nu putem anula sau returna banii. Ce să faci:

1. Răspunde direct la scrisoarea de la no-reply@astroway.life și folosește linkul “dezabonează / anulează” din subsolul ei.
2. Dacă nu răspund: contactează bancă sau emitatorul cardului tău (plata în extras - “Astroway”; merchant - TrafficLeader OÜ sau ABCMobile OÜ / SKYREAD.PRO, Estonia) și solicită să blochezi plățile recurente sau să faci returnare (chargeback).