Ana içeriğe geç

Horoskop Raporları API'si Genel Bakış

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

Motor Kalitesi Yazım Modeli Modlar Rapor Dili

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.

App UI Stats Activation Payload Chart Packs

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ı


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