Vue d'ensemble de l'API Horoscope Reports¶

Créez des produits astrologiques sur un moteur basé sur une éphéméride suisse, conçu pour les applications de production.

Cette API prend en charge deux modes de rapports de haute valeur :

Public mode pour une sortie stable basée sur les signes à grande échelle.
Personalized mode pour des rapports éditoriaux prenant en compte les données de naissance avec des vecteurs plus approfondis (maisons, aspects, dynamique temporelle).

Note sur la langue : les points de terminaison /api/v1/horoscope/reports/*, basés sur le moteur, prennent actuellement en charge uniquement l'anglais (lang=en). Les points de terminaison autres que les rapports peuvent prendre en charge des options de langue d'aide de traducteur, si elles sont documentées.

Clarté de la réponse du système du Zodiaque¶

Lorsque vous sélectionnez zodiac_system: "tropical", le calcul du rapport reste tropical. Lorsque vous sélectionnez zodiac_system: "sidereal", le calcul du rapport reste sidéral.

Si aucun zodiac_system n'est fourni dans le corps de la requête, le moteur par défaut vers tropical.

Vous pouvez toujours voir des champs liés au tropical, au sidéral et à l'ayanamsa dans les métadonnées de la réponse, quel que soit le mode sélectionné.Ces champs sont retournés uniquement à des fins de comparaison, de transparence et de surveillance. Ils ne modifient pas les calculs réels du rapport pour le système astrologique sélectionné.

Statistiques de l'interface utilisateur quotidienne¶

Les principaux points d'extrémité personnalisés quotidiens exposent des statistiques conviviales pour l'interface utilisateur à data.daily_personalized_stats.

Les statistiques quotidiennes personnalisées comprennent :

overall_pulse
archetype_scores
harmony_discord
elemental_balance
momentum_channels
confidence par bloc

Utilisez daily_stats_detail: "full" | "compact" pour contrôler la densité des données pour les clients mobiles/web.

Architecture¶

Architecture du moteur complet¶

Architecture complète du moteur astrologique

Architecture Requête-Réponse¶

Architecture Requête-Réponse astrologique

Décomposition de l'exécution¶

La pile astrologique de production suit un pipeline déterministe :1. L'API Gateway valide l'authentification, les quotas et les politiques de requête. 2. L'application FastAPI valide le contrat et vérifie la mise en cache. 3. HoroscopeService résout le signe, la période, la configuration de l'éphéméride et le mode. 4. EphemerisEngine calcule les positions, les aspects, les maisons et le signe ascendant. 5. AggregationEngine extrait les événements de période, les métriques et les principaux facteurs. 6. InterpretationEngine mappe les regroupements de facteurs à la sortie éditoriale avec traçabilité. 7. La réponse est assemblée, enveloppée de métadonnées et mise en cache.

Cette architecture permet d'obtenir des résultats reproductibles pour des charges utiles identiques, tout en permettant une personnalisation approfondie pour les expériences d'applications payantes.

Modèle de confiance : Noyau fermé + Open Source léger¶

Notre moteur principal est open source et optimisé pour des rapports déterministes de niveau entreprise, des couches éditoriales premium et une fiabilité de production.

Pour promouvoir la transparence et la confiance des développeurs, nous maintenons également un moteur open source léger et robuste :

Site web OpAstro : opastro.com
Source OpAstro : github.com/dakidarts/opastro
Paquet OpAstro : pypi.org/project/opastroUtilisez OpAstro pour évaluer rapidement la qualité du moteur, puis passez à des routes d'entreprise NumerologyAPI pour des couches de rapports plus riches, une couverture plus large des points de terminaison et des opérations de production gérées.

Commencez ici¶

Analyse approfondie du moteur : Présentation de notre moteur de prévisions
Notes de version : Changelog Numerology API v1.0.0
Routes de base :
Horoscope du jour
Horoscope du lendemain
Horoscope d'hier
Horoscope de l'anniversaire
Carte natale complète

Guide de démarrage rapide : Rapports quotidiens personnalisés + Statistiques de l'application¶

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

Cette requête renvoie un rapport quotidien en direct, ainsi que data.daily_personalized_stats pour les cartes et les modules de tendance de l'application.

Guide de sélection de routes¶

Objectif	Famille d'endpoints recommandée
Rapport quotidien basé sur le signe	`/horoscope/reports/today`, `/horoscope/reports/tomorrow`, `/horoscope/reports/yesterday`
Rapport quotidien personnalisé + cartes de statistiques de l'application	Routes principales avec `birth_time`, coordonnées et `daily_stats_detail`
Rapports généraux périodiques	`/horoscope/reports/weekly`, `/horoscope/reports/monthly`, `/horoscope/reports/yearly`
Rapports spécifiques à la section (carrière, santé, argent, communication, amitié, style de vie, amour)	Routes de section pour différentes périodes
Rapports éditoriaux axés sur les planètes	Routes planétaires
Rapports éditoriaux axés sur les aspects	Routes aspects
Rapports éditoriaux axés sur les transits	Routes transits
Rapports personnalisés axés sur la maison	Routes de maison
Rapports personnalisés planète-maison	Routes planète-maison
Carte du thème natal + artefacts de roue	Routes de carte du thème

Carte des endpoints¶

Utilisez cette carte pour accéder directement à la famille d'endpoints dont votre produit a besoin.

Carte du thème natal et fondations¶

Horoscope quotidien¶

Horoscope hebdomadaire¶

Horoscope mensuel¶

Horoscope annuel¶

Horoscope amoureux¶

Rapports planétaires, aspect, transit et maisons¶

Descriptions des Signes du Zodiaque (Pas de Rapports en Temps Réel)¶

Ces points de terminaison /api/v1/horoscope/sign/* renvoient des significations d'archétypes de signes, et non des rapports astrologiques en temps réel. Utilisez /api/v1/horoscope/reports/* pour la génération de rapports en temps réel. - Personnalité - Style de communication - Amitié et affinités - Amour et séduction - Style de vie et esthétique - Santé et vitalité - Spiritualité et mission - Modèles d'ombre - Carrière - Argent - Parent et enfant

Compatibilité et Encyclopédie¶

Idéal pour¶

Applications mobiles et web d'astrologie
Flux de rapports quotidiens et newsletters personnalisés
Produits de compatibilité et de relations
Tableaux de bord de bien-être, de coaching et de spiritualité
Intégrations d'entreprise nécessitant une reproductibilité déterminée

Alimenté par NumerologyAPI.com