# Genel bakış

**AstroWay API** — profesyonel bir arka uç astrolojik hesaplama hizmetidir.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} adet Swiss Ephemeris (WASM) tabanlı endpoint sunar. Rekabetin sunduğundan çok daha geniş teknikler sunar: armonikler, ejderha haritaları, CCG, Gauquelin sektörleri, tam Human Design ve doğum zamanı düzeltmesi.

## Kimler için?

1. **Astrolojik uygulama geliştiricileri** (web, mobil) — kendi hesaplama altyapısına sahip olmadan hassas ve çeşitli hesaplamalar yapmak isteyenler.
2. **AI şirketleri** — astrolojik özellikleri entegre etmek isteyenler. Claude, ChatGPT ve diğer ajanlar için yerel MCP sunucusu mevcut.
3. **Profesyonel astrologlar** — kendi araçlarını veya müşterileri için komut dosyalarını oluşturmak isteyenler.
4. **Araştırmacılar** — istatistiksel araştırmalar için programatik erişime ihtiyaç duyanlar.
5. **İçerik platformları** — mevcut ürünlerine astrolojik özellikler eklemek isteyenler.

## Kimler için **değil?**

- Kontrolsüz "bugün burç" widget'ları — AI yorumları ve burçlar mevcut (`/interpret/*`, `/horoscope/*`), ancak geliştiriciler için API olarak tasarlanmıştır, hazır widget olarak değil.
- Vedik astroloji — temel uzmanlık alanı olarak. Dasha sistemleri, Panchang, KP için Prokerala ve VedicAstroAPI daha güçlüdür. Batı astrolojisi + Human Design + nadir teknikler (doğum zamanı düzeltmesi, armonikler, CCG) için AstroWay rakiplerini geride bırakır. Karşılaştırma için /compare/ adresine bakın.
- Tarot/nümeroloji — sadece astroloji ve Human Design. I-Ching ise bonus bir endpoint olarak sunulmaktadır.

## AstroWay'i benzersiz kılan nedir?

### 1. API formatında nadir teknikler

| Teknik | Kullanım Amacı |
|---|---|
| **Armonik haritalar** (H2–H180) | Araştırmacı astroloji (John Addey metodu) |
| **Ejderha haritası** | Karma/ruhani astroloji |
| **CCG (Cyclo-Carto-Graphy)** | İlerletilmiş astrokartografi — Jim Lewis'in premium tekniği |
| **Gauquelin sektörleri** | İstatistiksel astroloji, akademik kullanım |
| **Üçüncü derece ilerlemeler** | Üçüncü tip ilerlemeler — niş bir teknik olsa da değerlidir |
| **Antisyonlar / karşı-antisyonlar** | Klasik Helenistik teknik — geleneksel okulların yeniden canlandırılması |
| **Paralel açılar** | Deklinasyon açılarında açılar — ileri uygulamalar |
| **API üzerinden doğum zamanı düzeltmesi** | Doğum zamanının düzeltilmesi — son derece değerli |
| **Gezegen döngüleri** (kavuşumlar) | Mundane astroloji — dünya olayları |
| **Barbo'nun döngüsel endeksi** | Mundane astroloji |
| **Algol Minimumu** | Sabit yıldız zamanları — elektif astroloji |
| **Yerel uzay çizgileri** | Feng shui benzeri yönlendirici astroloji |
| **Diziliş zincirleri** | Kontrol grafikleri — klasik teknik |
| **Figuris Almutens** | Ortaçağ tekniği — gelenekselcanlandırma |

### 2. Swiss Ephemeris hassasiyeti — Solar Fire ($495), Kepler ($995), Astro Gold'da kullanılan aynı motor

Profesyonel astrologların 30 yıldan uzun süredir Solar Fire, Kepler, Astro Gold ve Janus'ta kullandığı Swiss Ephemeris (LGPL) — sadece WASM derlemesi ve REST API olarak sunulmakta, aracı fiyatlandırması olmadan. Hassasiyet:

- Gezegen konumları: NASA JPL efemerislerine karşı ±1 yay saniyesi
- Ev küspitleri: ±1 yay dakikası
- Zet 9, Solar Fire (lisanslı efemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold'a karşı doğrulama — farklar yöntemin hata payı içinde (≤0.1″).

### 3. {siteMeta.endpoints} endpoint — Batı astrolojisinin derinlemesine kapsamı

{siteMeta.westernCount} Batı astrolojisinin hesaplama endpointi (4 Helenistik okul, modern psikolojik, evrimsel, kozmobiyoloji) + AI yorumları + tam Human Design. Birçok farklı alana dağılmak yerine derinlemesine odaklanma.

## Mimarisi

```
Senin uygulaman
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Hesaplama ve JSON yanıtı
```

- Hesaplamalar **sunucu tarafında** gerçekleştirilir — uygulamanın ön yüzünde WASM blob'ları yok, Swiss Ephemeris lisans sorunları yok.
- Sunucu tarafında durum saklanmaz — her istek kendi içinde yeterli. Müşteri verilerinin sızdırılması riski yok.
- API anahtarları plana bağlıdır, rate limit ve günlük kredi bakiyesi bulunur. Kontrol paneli üzerinden izleme yapılabilir.

## Sonraki adımlar

- [Hızlı başlangıç](/getting-started/) — 5 dakika içinde ilk istek
- [Kimlik doğrulama](/authentication/) — anahtar nasıl alınır ve saklanır
- [Krediler ve limitler](/rate-limits-credits/) — faturalandırma nasıl çalışır
- [API dokümantasyonu](/docs/api/) — tüm endpoint'ler interaktif playground ile