Horoskop Raporları API'si Genel Bakış¶

Üretim uygulamaları için tasarlanmış, deterministik bir Swiss Ephemeris motoru üzerinde astrologi ürünleri oluşturun.

Bu API, iki yüksek değerli rapor modu destekler:

Public mode, büyük ölçekte kararlı işaret tabanlı çıktı için.
Personalized mode, doğum verilerine duyarlı yazım raporları ve daha derin vektörler (evler, açılar, zaman dinamikleri) için.

Dil notu: motor tarafından desteklenen /api/v1/horoscope/reports/* uç noktaları şu anda yalnızca İngilizceyi desteklemektedir (lang=en). Rapor olmayan uç noktalar, belgelenmiş şekilde çeviri yardımcı dil seçeneklerini destekleyebilir.

Zodyak Sistemi Yanıt Netliği¶

zodiac_system: "tropical" seçtiğinizde, rapor hesaplaması tropikal kalır. zodiac_system: "sidereal" seçtiğinizde, rapor hesaplaması sidereal kalır.

İsteğin gövdesinde zodiac_system sağlanmazsa, motor varsayılan olarak tropical'e geçer.

Seçilen moddan bağımsız olarak yanıt meta verilerinde yine de tropikal, sidereal ve ayanamsa ile ilgili alanları görebilirsiniz.These fields are returned for comparison, transparency, and observability only. They do not override or alter the actual report calculations for the selected zodiac system.

Daily App UI Stats Spotlight¶

Main daily personalized endpoints expose rich UI-friendly stats at data.daily_personalized_stats.

Personalized daily stats include:

overall_pulse
archetype_scores
harmony_discord
elemental_balance
momentum_channels
confidence tiers per block

Use daily_stats_detail: "full" | "compact" to control payload density for mobile/web clients.

Architecture¶

Full Engine Architecture¶

Full Horoscope Engine Architecture

Request to Response Architecture¶

Horoscope Request-to-Response Architecture

Runtime Breakdown¶

The production horoscope stack follows a deterministic pipeline:1. API Gateway, kimlik doğrulaması, kota ve istek politikasını doğrular. 2. FastAPI uygulaması sözleşmeyi doğrular ve önbelleği kontrol eder. 3. HoroscopeService, imza, zaman aralığını, ephemeris ayarlarını ve modu çözümler. 4. EphemerisEngine, konumları, açıları, evleri ve yükselen işareti hesaplar. 5. AggregationEngine, zaman aralığındaki olayları, metrikleri ve sıralanmış sürücüleri çıkarır. 6. InterpretationEngine, faktör gruplarını izlenebilirlik ile editörel çıktıya eşler. 7. Yanıt oluşturulur, meta verilerle sarılır ve önbelleğe alınır.

Bu mimari, aynı yükler için tekrarlanabilir çıktılar sağlar, ancak aynı zamanda ücretli uygulama deneyimleri için derin kişiselleştirme olanağı sunar.

Güven Modeli: Kapalı Çekirdek + Açık Kaynak Hafif¶

Ana motorumuz kapalı kaynaklıdır ve kurumsal düzeydeki deterministik raporlar, premium editörel katmanlar ve üretim güvenilirliği için optimize edilmiştir.

Şeffaflığı ve geliştirici güvenini teşvik etmek için ayrıca sağlam, hafif bir açık kaynaklı motor da sürdürüyoruz:

OpAstro web sitesi: opastro.com
OpAstro kaynağı: github.com/dakidarts/opastro
OpAstro paketi: pypi.org/project/opastroHızlı bir şekilde motor kalitesini değerlendirmek için OpAstro'yu kullanın, ardından daha zengin rapor katmanları, daha geniş uç nokta kapsamı ve yönetilen üretim operasyonları için NumerologyAPI kurumsal rotalarına ölçeklendirin.

Başlangıç Noktası¶

Motorun derinlemesine incelemesi: Horoskop Motorumuzu Tanıtıyoruz- Yayın notları: Numerology API v1.0.0 Değişiklik Günlüğü- Temel genel bakış rotaları:- Bugünün Horoskopu- Yarınki Horoskop- Dününkü Horoskop- Doğum Günü Horoskopu- Tam Doğum Haritası

Hızlı Başlangıç: Kişiselleştirilmiş Günlük + Uygulama İstatistikleri¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "dob": "1992-07-16",
  "timezone": "America/New_York",
  "birth_time": "13:45",
  "birth_latitude": 40.7128,
  "birth_longitude": -74.0060,
  "birth_timezone": "America/New_York",
  "daily_stats_detail": "compact"
}'

Bu, günlük bir rapor ve ayrıca uygulama kartları ve trend modülleri için data.daily_personalized_stats değerini döndürür.

Rota Seçimi Rehberi¶

Amaç	Önerilen Endpoint Ailesi
Genel, burcun dayalı günlük rapor	`/horoscope/reports/today`, `/horoscope/reports/tomorrow`, `/horoscope/reports/yesterday`
Kişiselleştirilmiş günlük rapor + uygulama istatistikleri kartları	Ana günlük rotalar ile `birth_time`, koordinatlar ve `daily_stats_detail`
Periyodik genel raporlar	`/horoscope/reports/weekly`, `/horoscope/reports/monthly`, `/horoscope/reports/yearly`
Bölüm özel raporlar (kariyer, sağlık, para, iletişim, arkadaşlık, yaşam tarzı, aşk)	Periyotlara göre bölümler arası rotalar
Gezegen odaklı editöryal raporlar	Gezegen rotaları
Aspect odaklı editöryal raporlar	Aspect rotaları
Transit odaklı editöryal raporlar	Transit rotaları
Ev odaklı kişiselleştirilmiş raporlar	Ev rotaları
Gezegen-ev kişiselleştirilmiş raporlar	Gezegen-ev rotaları
Yüksek detaylı doğum haritası + tekerlek öğeleri	Doğum haritası rotaları

Endpoint Haritası¶

Ürününüzün ihtiyaç duyduğu tam olarak doğru rota ailesine doğrudan ulaşmak için bu haritayı kullanın.

Doğum Haritası ve Temeller¶

Günlük Horoskop¶

Haftalık Horoskop¶

Aylık Horoskop¶

Yıllık Horoskop¶

Aşk Horoskopu¶

Gezegen, Aspect, Transit ve Ev Raporları¶

```- Gezegens Günlük Bölümleri - Gezegens Haftalık Bölümleri - Gezegens Aylık Bölümleri - Gezegens Yıllık Bölümleri - Gezegens Günlük Genel Bakış - Gezegens Haftalık Genel Bakış - Gezegens Aylık Genel Bakış - Gezegens Yıllık Genel Bakış - Aspects Günlük Bölümleri - Aspects Haftalık Bölümleri - Aspects Aylık Bölümleri - Aspects Yıllık Bölümleri - Aspects Günlük Genel Bakış - Aspects Haftalık Genel Bakış - Aspects Aylık Genel Bakış - Aspects Yıllık Genel Bakış - Transits Günlük Bölümleri - Transits Haftalık Bölümleri - Transits Aylık Bölümleri - Transits Yıllık Bölümleri - Transits Günlük Genel Bakış - Transits Haftalık Genel Bakış - Transits Aylık Genel Bakış - Transits Yıllık Genel Bakış - House Günlük Bölümleri - House Haftalık Bölümleri- Ev Aylık Bölümleri - Ev Yıllık Bölümleri - Ev Günlük Genel Bakış - Ev Haftalık Genel Bakış - Ev Aylık Genel Bakış - Ev Yıllık Genel Bakış - Geçici-Ev Günlük Bölümleri - Geçici-Ev Haftalık Bölümleri - Geçici-Ev Aylık Bölümleri - Geçici-Ev Yıllık Bölümleri - Geçici-Ev Günlük Genel Bakış - Geçici-Ev Haftalık Genel Bakış - Geçici-Ev Aylık Genel Bakış - Geçici-Ev Yıllık Genel Bakış

Burç Tanımı Açıklamaları (Canlı Raporlar Değil)¶

Bu /api/v1/horoscope/sign/* uç noktaları, açıklayıcı burç arket tipi anlamlarını döndürür, canlı astrologik raporlar değil. Canlı rapor oluşturmak için /api/v1/horoscope/reports/* kullanın.- Kişilik Özelliklerini Anlama - İletişim Tarzı - Arkadaşlık ve Uyumlar - Aşk ve Çekicilik - Yaşam Tarzı ve Estetik - Sağlık ve Yaşam Enerjisi - Ruhsal Yön ve Amel Misyonu - Karanlık Kalıplar - Kariyer - Para - Anne ve Çocuk İlişkisi

Uyumluluk ve Ensiklopedik Bilgi¶

En İyi Kullanım Alanları¶

Astroloji mobil ve web uygulamaları
Kişiselleştirilmiş günlük rapor beslemeleri ve bültenler
Uyumluluk ve ilişkisel ürünler
Sağlık, koçluk ve ruhsal paneller
İşletme entegrasyonları için deterministik tekrar ihtiyacı

NumerologyAPI.com tarafından sağlanmaktadır