# Horoskop ve AI Yorumları API

10 AI uç noktası — AstroWay platformunun 700+ uc noktasından oluşan sisteminin bir parçasıdır (16 kategori). 5’i burç yorumları (günlük, haftalık, aylık, yıllık, uyumluluk) ve 5’i yorumlama (natal, sinastri, transitler, element, yerleşim) için. Tüm hesaplamalar Swiss Ephemeris’e dayanmaktadır (aynı sistem Solar Fire ve Astrodienst’te de kullanılan sistemdir) — sadece şablonlara veya saf LLM halüsinasyonlarına değil.

## Nasıl çalışır?

1. API, Swiss Ephemeris kullanarak gerçek astrolojik haritayı (transitler, natal, sinastri) hesaplar
2. Sonuç, piyasadaki en iyi modellerin (Google Gemini → Groq Llama 3.3 → OpenRouter’dan GPT-4 / Claude / DeepSeek → Cerebras → SambaNova → Mistral) üzerinden AI-gateway’e gönderilir ve astrolojik system prompt ile otomatik failover uygulanır
3. LLM, yerleşik güvenlik korumalarıyla (tıbbi/yasal/finansal tavsiyelerin yasaklanması) metin üretir
4. Yanıt, bir disclaimer ve denetim izi içerir

<Aside type="tip">
AI uç noktaları hem hesaplamaları hem de metni döndürür. Sadece hesaplamaları kullanabilir ve metni kendi LLM’inizle üretebilirsiniz (daha ucuz uç noktalar).
</Aside>

## Uç noktalar — Burç yorumları

| Uç nokta | Krediler | Üretilen içerik |
|---|---|---|
| `/v1/horoscope/daily` | 20 | Mevcut transitlere dayalı günlük burç yorumu |
| `/v1/horoscope/weekly` | 20 | Haftalık genel bakış |
| `/v1/horoscope/monthly` | 20 | Aylık tahmin |
| `/v1/horoscope/yearly` | 50 | Yıllık tahmin |
| `/v1/horoscope/compatibility` | 50 | Uyumluluk analizi metni |

## Uç noktalar — Yorumlama

| Uç nokta | Krediler | Yorumlanan içerik |
|---|---|---|
| `/v1/interpret/natal` | 50 | Natal haritanın tam yorumu |
| `/v1/interpret/synastry` | 50 | Sinastri yorumu |
| `/v1/interpret/transits` | 50 | Mevcut transitlerin yorumu |
| `/v1/interpret/element` | 20 | Belirli bir elementin yorumu (gezegenin burçtaki konumu, açı) |
| `/v1/interpret/placement` | 20 | Yerleşimin yorumu (gezegenin evdeki konumu) |

## Örnek

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/horoscope/daily \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data: horoscope } = await r.json();
    console.log(horoscope.text);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/horoscope/daily',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    horoscope = r.json()['data']
    print(horoscope['text'])
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('horoscope/daily', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $horoscope = json_decode($r->getBody(), true)['data'];
    echo $horoscope['text'];
    ```
  </TabItem>
</Tabs>

## Güvenlik korumaları

Tüm AI uç noktalarında yerleşik koruma bulunur:

- **System prompt** tıbbi, yasal ve finansal tavsiyelerin açıkça yasaklanmasıyla
- **Otomatik eklenen disclaimer** her yanıtta
- **İçerik filtresi** — anahtar kelimelere göre son filtreleme
- **Denetim izi** — prompt’ların ve yanıtların loglanması (90 gün saklama)
- **`disclaimer_inline: true`** — metni zaten disclaimer ile birlikte almak isteyen kurumsal kullanıcılar için bir parametre

<Aside type="caution">
AI yorumları eğlence amaçlıdır. Profesyonel bir astrolog, doktor, avukat veya finansal danışmanın yerini almaz.
</Aside>

## Kimler kullanıyor?

- **İçerik platformları** — kullanıcıları için günlük burç yorumları
- **Astroloji uygulamaları** — generic metinler yerine kişiselleştirilmiş yorumlar
- **AI ajanları** — MCP sunucusu veya doğrudan API çağrısı üzerinden
- **Medya** — gerçek verilere dayalı astroloji içeriği üretimi

## Ücretlendirme

Günlük burç yorumu — **20 kredi**. Tam natal harita yorumu — **50 kredi**. Ücretsiz planda ayda 250 günlük burç yorumu veya 100 yorumlama hakkı bulunur.

<CardGrid>
  <LinkCard title="Hızlı başlangıç →" href="/getting-started/" description="İlk isteği 5 dakikada yap" />
  <LinkCard title="AI ajanları ve MCP" href="/use-cases/ai-agents/" description="Claude, ChatGPT ile entegrasyon" />
  <LinkCard title="Ücretlendirme" href="/pricing/" description="Ücretsizden kurumsala kadar" />
</CardGrid>