Lewati ke isi

Ikhtisar API Laporan Horoskop

Bangun produk astrologi pada mesin Swiss Ephemeris yang deterministik, dirancang untuk aplikasi produksi.

Kualitas Mesin Model Editorial Mode Bahasa Laporan

API ini mendukung dua mode laporan dengan nilai tinggi:

  • Public mode untuk output berbasis tanda yang stabil dalam skala besar.
  • Personalized mode untuk laporan editorial berdasarkan data kelahiran, dengan vektor yang lebih mendalam (rumah, aspek, dinamika waktu).

Catatan bahasa: titik akhir mesin yang didukung /api/v1/horoscope/reports/* saat ini hanya mendukung Bahasa Inggris (lang=en). Titik akhir non-laporan mungkin mendukung opsi bahasa pembantu penerjemah jika didokumentasikan.

Kejelasan Respons Sistem Zodiak

Saat Anda memilih zodiac_system: "tropical", perhitungan laporan tetap menggunakan sistem tropis. Saat Anda memilih zodiac_system: "sidereal", perhitungan laporan tetap menggunakan sistem sidereal.

Jika tidak ada zodiac_system yang disediakan dalam badan permintaan, mesin secara default menggunakan tropical.

Anda mungkin masih melihat bidang terkait tropis, sidereal, dan ayanamsa di metadata respons terlepas dari mode yang dipilih.Data ini hanya dikembalikan untuk perbandingan, transparansi, dan observabilitas. Data ini tidak menggantikan atau mengubah perhitungan laporan aktual untuk sistem astrologi yang dipilih.

Statistik UI Aplikasi Harian

Titik akhir harian yang dipersonalisasi utama mengekspos statistik yang ramah UI yang kaya di data.daily_personalized_stats.

Statistik UI Aplikasi Aktivasi Payload Paket Grafik

Statistik harian yang dipersonalisasi meliputi:

  • overall_pulse
  • archetype_scores
  • harmony_discord
  • elemental_balance
  • momentum_channels
  • confidence per blok

Gunakan daily_stats_detail: "full" | "compact" untuk mengontrol kepadatan payload untuk klien seluler/web.

Arsitektur

Arsitektur Mesin Lengkap

Arsitektur Mesin Horoskop Lengkap

Arsitektur Permintaan ke Respons

Arsitektur Permintaan-ke-Respons Horoskop

Pemecahan Runtime

Tumpukan horoskop produksi mengikuti pipeline yang deterministik:1. API Gateway memvalidasi autentikasi, kuota, dan kebijakan permintaan. 2. Aplikasi FastAPI memvalidasi kontrak dan memeriksa cache. 3. HoroscopeService menyelesaikan tanda, periode waktu, konfigurasi ephemeris, dan mode. 4. EphemerisEngine menghitung posisi, aspek, rumah, dan tanda kelahiran. 5. AggregationEngine mengekstrak peristiwa periode, metrik, dan penggerak yang diberi peringkat. 6. InterpretationEngine memetakan tumpukan faktor ke output editorial dengan pelacakan. 7. Respons dirakit, dibungkus dengan metadata, dan di-cache.

Arsitektur ini memberikan hasil yang dapat direproduksi untuk payload yang identik sambil tetap memungkinkan personalisasi mendalam untuk pengalaman aplikasi berbayar.

Model Kepercayaan: Inti Tertutup + Sumber Terbuka Ringan

Mesin utama kami bersifat sumber tertutup dan dioptimalkan untuk laporan deterministik tingkat perusahaan, lapisan editorial premium, dan keandalan produksi.

Untuk mempromosikan transparansi dan kepercayaan pengembang, kami juga mempertahankan mesin sumber terbuka ringan yang kuat:

  • Situs web OpAstro: opastro.com
  • Sumber OpAstro: github.com/dakidarts/opastro
  • Paket OpAstro: pypi.org/project/opastroGunakan OpAstro untuk mengevaluasi kualitas mesin dengan cepat, lalu skalakan ke rute NumerologyAPI perusahaan untuk lapisan laporan yang lebih kaya, cakupan endpoint yang lebih luas, dan operasi produksi yang dikelola.

Mulai di Sini

Panduan Cepat: Laporan Harian + Statistik Aplikasi yang Dipersonalisasi

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"
}'

Ini mengembalikan laporan harian secara langsung, serta data.daily_personalized_stats untuk kartu aplikasi dan modul tren.

Panduan Pemilihan Rute| Tujuan | Rekomendasi Keluarga Endpoint |

|---|---| | Laporan harian berdasarkan tanda zodiak | /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday | | Laporan harian yang dipersonalisasi + kartu statistik aplikasi | Rute utama harian dengan birth_time, koordinat, dan daily_stats_detail | | Laporan umum secara berkala | /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly | | Laporan spesifik bagian (karir, kesehatan, keuangan, komunikasi, persahabatan, gaya hidup, cinta) | Rute bagian di berbagai periode | | Laporan editorial berfokus pada planet | Rute planet | | Laporan editorial berfokus pada aspek | Rute aspek | | Laporan editorial berfokus pada transit | Rute transit | | Laporan pribadi yang berfokus pada rumah | Rute rumah | | Laporan pribadi planet-rumah | Rute planet-rumah | | Bagan kelahiran lengkap + artefak roda | Rute bagan kelahiran |

Peta Endpoint

Gunakan peta ini untuk langsung menuju keluarga rute yang tepat yang dibutuhkan oleh produk Anda.

Bagan Kelahiran dan Dasar-Dasar

Horoskop Harian- Horoskop Hari Ini

Horoskop Mingguan- Horoskop Mingguan Umum

Horoskop Bulanan

Horoskop Tahunan

Horoskop Cinta

Laporan Planet, Aspek, Transit, dan Rumah- Bagian Harian Planet

Deskripsi Tanda Zodiak (Bukan Laporan Langsung)

Endpoint /api/v1/horoscope/sign/* ini mengembalikan makna arketipe tanda, bukan laporan astrologi langsung. Gunakan /api/v1/horoscope/reports/* untuk menghasilkan laporan langsung.- Kepribadian - Gaya Komunikasi - Persahabatan dan Kesesuaian - Cinta dan Daya Tarik - Gaya Hidup dan Estetika - Kesehatan dan Vitalitas - Spiritualitas dan Tujuan Hidup - Pola Bayangan - Karir - Keuangan - Orang Tua dan Anak

Kompatibilitas dan Ensiklopedia

Cocok Untuk

  • Aplikasi seluler dan web astrologi
  • Umpan dan buletin laporan harian yang dipersonalisasi
  • Produk kompatibilitas dan hubungan
  • Dasbor kesehatan, pelatihan, dan spiritual
  • Integrasi perusahaan yang membutuhkan determinisme dan pengulangan

Didukung oleh NumerologyAPI.com