Saltar a contenido

Resumen de la API de Informes de Horóscopo

Cree productos de astrología utilizando un motor determinista impulsado por la Ephemeris suiza, diseñado para aplicaciones de producción.

Calidad del Motor Modelo Editorial Modos Idioma de los Informes

Esta API admite dos modos de informe de alto valor:

  • Public mode para una salida estable basada en signos a gran escala.
  • Personalized mode para informes editoriales conscientes de los datos de nacimiento con vectores más profundos (casas, aspectos, dinámica temporal).

Nota sobre el idioma: los puntos finales de motor con /api/v1/horoscope/reports/* actualmente solo admiten inglés (lang=en). Los puntos finales que no son de informe pueden admitir opciones de idioma de ayuda del traductor, según lo documentado.

Claridad de la Respuesta del Sistema Zodiacal

Cuando selecciona zodiac_system: "tropical", el cálculo del informe permanece tropical. Cuando selecciona zodiac_system: "sidereal", el cálculo del informe permanece sideral.

Si no se proporciona zodiac_system en el cuerpo de la solicitud, el motor predetermina tropical.

Aún puede ver campos relacionados con tropical, sideral y ayanamsa en los metadatos de la respuesta, independientemente del modo seleccionado.Estos campos se devuelven únicamente para comparación, transparencia y observabilidad. No modifican ni alteran los cálculos reales del informe para el sistema zodiacal seleccionado.

Estadísticas de la Interfaz de Usuario Diaria

Los endpoints diarios personalizados principales exponen estadísticas ricas y fáciles de usar en data.daily_personalized_stats.

Estadísticas de la Interfaz de Usuario Activación Carga Paquetes de Gráficos

Las estadísticas diarias personalizadas incluyen:

  • overall_pulse
  • archetype_scores
  • harmony_discord
  • elemental_balance
  • momentum_channels
  • confidence por bloque

Utilice daily_stats_detail: "full" | "compact" para controlar la densidad de la carga para clientes móviles/web.

Arquitectura

Arquitectura del Motor Completo

Arquitectura del Motor Horóscopo Completo

Arquitectura de Solicitud a Respuesta

Arquitectura de Solicitud-a-Respuesta Horóscopo

Desglose del Tiempo de Ejecución

La pila horóscopa de producción sigue una tubería determinista:1. El gateway de API valida la autenticación, el límite de cuotas y la política de la solicitud. 2. La aplicación FastAPI valida el contrato y comprueba la caché. 3. HoroscopeService resuelve la firma, el período, la configuración de la ephemeris y el modo. 4. EphemerisEngine calcula las posiciones, los aspectos, las casas y el signo ascendente. 5. AggregationEngine extrae los eventos del período, las métricas y los impulsores clasificados. 6. InterpretationEngine mapea los grupos de factores a la salida editorial con trazabilidad. 7. La respuesta se ensambla, se envuelve con metadatos y se almacena en caché.

Esta arquitectura proporciona resultados repetibles para cargas útiles idénticas, al tiempo que permite una personalización profunda para las experiencias de aplicaciones de pago.

Modelo de Confianza: Núcleo Cerrado + Código Abierto Ligero

Nuestro motor principal es de código cerrado y optimizado para informes deterministas de nivel empresarial, capas editoriales premium y fiabilidad en producción.

Para promover la transparencia y la confianza del desarrollador, también mantenemos un motor ligero de código abierto robusto:

  • Sitio web de OpAstro: opastro.com
  • Código fuente de OpAstro: github.com/dakidarts/opastro
  • Paquete de OpAstro: pypi.org/project/opastroUtilice OpAstro para evaluar rápidamente la calidad del motor, y luego utilice las rutas empresariales de NumerologyAPI para obtener informes más ricos, una cobertura más amplia de puntos finales y operaciones de producción gestionadas.

Comience aquí

Guía de inicio rápido: Informe diario personalizado + estadísticas de la aplicación

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

Esto devuelve un informe diario en vivo, además de data.daily_personalized_stats para tarjetas y módulos de tendencias de la aplicación.

Guía de selección de rutas

Objetivo Familia de Endpoints Recomendada
Informe diario general basado en signos /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday
Informe diario personalizado + tarjetas de estadísticas de la aplicación Rutas principales diarias con birth_time, coordenadas y daily_stats_detail
Informes generales periódicos /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly
Informes específicos por sección (carrera, salud, dinero, comunicación, amistad, estilo de vida, amor) Rutas por sección en diferentes períodos
Informes editoriales centrados en planetas Rutas planetarias
Informes editoriales centrados en aspectos Rutas de aspectos
Informes editoriales centrados en tránsito Rutas de tránsito
Informes personalizados centrados en casas Rutas de casas
Informes personalizados de planetas y casas Rutas de planetas y casas
Carta natal detallada + artefactos de la rueda Rutas de la carta natal

Mapa de Endpoints

Utilice este mapa para acceder directamente a la familia de rutas exacta que necesita su producto.

Carta Natal y Fundamentos

Horóscopo Diario

Horóscopo semanal

Horóscopo Mensual

Horóscopo Anual

Horóscopo de Amor

Informes de Planetas, Aspectos, Transit y Casas

Descripciones de Signos del Zodíaco (No Informes en Vivo)

Estos /api/v1/horoscope/sign/* endpoints devuelven significados de arquetipos de signos, no informes astrológicos en vivo. Utilice /api/v1/horoscope/reports/* para la generación de informes en vivo. - Personalidad - Estilo de Comunicación - Amistad y Afinidad - Amor y Seducción - Estilo de Vida y Estética - Salud y Vitalidad - Espiritualidad y Propósito - Patrones de Sombra - Carrera Profesional - Finanzas - Padres e Hijos

Compatibilidad y Enciclopedia

Ideal para

  • Aplicaciones móviles y web de astrología
  • Feeds y boletines informativos diarios personalizados
  • Productos de compatibilidad y relaciones
  • Paneles de control de bienestar, coaching y espiritualidad
  • Integraciones empresariales que requieren repetibilidad determinista

Impulsado por NumerologyAPI.com