# Prezentare generală

**AstroWay API** — un serviciu profesional de backend pentru calcule astrologice bazat pe REST.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} de endpoint-uri bazate pe Swiss Ephemeris (WASM), acoperind tehnici pe care niciun competitor nu le oferă: armonice, hărți dragonice, CCG, sectoare Gauquelin, Human Design complet, rectificare.

## Pentru cine este

1. **Dezvoltatorii de aplicații astrologice** (web, mobile) care au nevoie de calcule precise și diverse fără propria infrastructură de calcul.
2. **Companiile AI** care integrează funcții astrologice — există un server MCP nativ pentru Claude, ChatGPT și alți agenți.
3. **Astrologii profesioniști** care își construiesc propriile instrumente sau scripturi pentru clienți.
4. **Cercetătorii** care au nevoie de acces programatic la calcule pentru studii statistice.
5. **Platformele de conținut** care adaugă funcții astrologice peste produsul existent.

## Pentru cine **nu** este

- Widgeturi de horoscop simpliste „zodia de azi” fără control — interpretările AI și horoscoapele sunt disponibile (`/interpret/*`, `/horoscope/*`), dar sunt proiectate ca API pentru dezvoltatori, nu ca widgeturi gata de folosit.
- Astrologia vedică ca specializare principală — pentru proiecte Vedic-first (sisteme Dasha, Panchang, KP), Prokerala și VedicAstroAPI sunt mai puternice. Pentru astrologia occidentală + Human Design + tehnici rare (rectificare, armonice, CCG), AstroWay le depășește. Vezi /compare/.
- Tarot/ numerologie — doar astrologie și Human Design. I-Ching este disponibil ca endpoint bonus.

## Ce face AstroWay unic

### 1. Tehnici rare în format API

| Tehnică | Utilitate |
|---|---|
| **Hărți armonice** (H2–H180) | Astrologie de cercetare (metoda lui John Addey) |
| **Hartă dragonică** | Astrologie karmică/ spirituală |
| **CCG (Cyclo-Carto-Graphy)** | Cartografie astrologică progresivă — tehnică premium a lui Jim Lewis |
| **Sectoare Gauquelin** | Astrologie statistică, utilizare academică |
| **Progresii tertiare** | Al treilea tip de progresii — de nișă, dar apreciat |
| **Antiscții / Contra-antiscții** | Tehnică elenistică clasică — renașterea școlilor tradiționale |
| **Aspecte paralele** | Aspecte prin decilinație — practici avansate |
| **Rectificare prin API** | Corectarea orei de naștere — valoare extrem de ridicată |
| **Cicluri planetare** (conjuncții) | Astrologie mundană — evenimente globale |
| **Indicele ciclic Barbo** | Astrologie mundană |
| **Minimul Algol** | Timpuri de stele fixe — astrologie electivă |
| **Linii de spațiu local** | Astrologie direcțională asemănătoare Feng Shui |
| **Lanțuri de dispoziție** | Grafuri de control — tehnică clasică |
| **Almuten figuris** | Tehnică medievală — renaștere tradițională |

### 2. Precizia Swiss Ephemeris — același motor folosit în Solar Fire ($495), Kepler ($995), Astro Gold

Același Swiss Ephemeris (LGPL), folosit de astrologii profesioniști în Solar Fire, Kepler, Astro Gold și Janus de peste 30 de ani — doar în variantă WASM și ca REST API, fără adaosuri de intermediari. Precizia:

- Poziții planetare: ±1 secundă de arc vs. ephemeris NASA JPL
- Cuspidă case: ±1 minut de arc
- Validare împotriva Zet 9, Solar Fire (ephemeris proprietar), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — discrepanțe în limita erorii metodei (≤0.1″).

### 3. {siteMeta.endpoints} de endpoint-uri — acoperire profundă a tehnicilor occidentale

{siteMeta.westernCount} de endpoint-uri de calcul pentru astrologia occidentală (4 școli: helenistică, psihologică modernă, evolutivă, cosmobiologie) + interpretări AI + Human Design complet. Profunzime în loc de dispersare pe zeci de direcții.

## Arhitectură

```
Aplicația ta
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Calcul și returnare JSON
```

- Calculele sunt executate **pe server** — niciun blob WASM pe frontend-ul aplicației tale, niciun fel de probleme de licențiere Swiss Ephemeris.
- Starea nu este păstrată pe server — fiecare cerere este independentă. Niciun risc de scurgere de date despre clienți.
- Cheile API sunt legate de plan, limită de rate și sold zilnic de credite. Monitorizare prin dashboard.

## Mai departe

- [Începe rapid](/getting-started/) — prima cerere în 5 minute
- [Autentificare](/authentication/) — cum să obții și să stochezi cheia
- [Credite și limite](/rate-limits-credits/) — cum funcționează facturarea
- [Documentația API](/docs/api/) — toate endpoint-urile cu playground interactiv