Ir para o conteúdo

Visão Geral da API de Relatórios de Horóscopo

Crie produtos de astrologia em um motor determinístico, baseado na Ephemeris suíça, projetado para aplicações de produção.

Qualidade do Motor Modelo Editorial Modos Linguagem dos Relatórios

Esta API suporta dois modos de relatório de alto valor:

  • Public mode para saída estável baseada em signos em grande escala.
  • Personalized mode para relatórios editoriais conscientes dos dados de nascimento com vetores mais profundos (casas, aspectos, dinâmica de tempo).

Nota sobre a linguagem: os endpoints do motor /api/v1/horoscope/reports/* suportam atualmente apenas inglês (lang=en). Os endpoints não relacionados a relatórios podem suportar opções de idioma de assistente de tradução, conforme documentado.

Clareza da Resposta do Sistema Zodiacal

Quando você seleciona zodiac_system: "tropical", o cálculo do relatório permanece tropical. Quando você seleciona zodiac_system: "sidereal", o cálculo do relatório permanece sideral.

Se nenhum zodiac_system for fornecido no corpo da solicitação, o motor retorna para tropical.

Você ainda pode ver campos relacionados a tropical, sideral e ayanamsa na metadados da resposta, independentemente do modo selecionado.Estes campos são retornados apenas para fins de comparação, transparência e observabilidade. Não substituem nem alteram os cálculos reais do relatório para o sistema de zodíaco selecionado.

Estatísticas Diárias da Interface do Usuário

Os endpoints diários personalizados expõem estatísticas ricas e amigáveis para a interface do usuário em data.daily_personalized_stats.

Estatísticas da Interface do Usuário Ativação Payload Pacotes de Gráficos

As estatísticas diárias personalizadas incluem:

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

Use daily_stats_detail: "full" | "compact" para controlar a densidade do payload para clientes móveis/web.

Arquitetura

Arquitetura do Motor Completo

Arquitetura do Motor Horoscópico Completo

Arquitetura de Solicitação para Resposta

Arquitetura de Solicitação-Resposta Horoscópica

Detalhamento da Execução

A pilha horoscópica de produção segue um pipeline determinístico:1. O Gateway de API valida a autenticação, o limite de uso e a política de requisição. 2. A aplicação FastAPI valida o contrato e verifica o cache. 3. HoroscopeService resolve o sinal, a janela de período, a configuração da ephemeris e o modo. 4. EphemerisEngine calcula as posições, os aspectos, as casas e o signo ascendente. 5. AggregationEngine extrai os eventos do período, as métricas e os principais fatores. 6. InterpretationEngine mapeia os agrupamentos de fatores para a saída editorial com rastreabilidade. 7. A resposta é montada, envolvida com metadados e armazenada em cache.

Esta arquitetura fornece resultados repetíveis para payloads idênticos, ao mesmo tempo em que permite uma personalização profunda para experiências de aplicativos pagos.

Modelo de Confiança: Núcleo Fechado + Código Aberto Leve

Nosso principal motor é de código fechado e otimizado para relatórios determinísticos de nível empresarial, camadas editoriais premium e confiabilidade de produção.

Para promover a transparência e a confiança dos desenvolvedores, também mantemos um motor leve de código aberto robusto:

  • Site OpAstro: opastro.com
  • Código fonte OpAstro: github.com/dakidarts/opastro
  • Pacote OpAstro: pypi.org/project/opastroUse o OpAstro para avaliar rapidamente a qualidade do motor, e, em seguida, dimensione para as rotas empresariais do NumerologyAPI para camadas de relatório mais ricas, cobertura de endpoints mais ampla e operações de produção gerenciadas.

Comece Aqui

Guia de Início Rápido: Relatório Diário + Estatísticas do Aplicativo Personalizadas

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

Isso retorna um relatório diário em tempo real, além de data.daily_personalized_stats para cartões e módulos de tendências do aplicativo.

Guia de Seleção de Rotas

Objetivo Família de Endpoints Recomendada
Relatório diário geral baseado em signos /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday
Relatório diário personalizado + cartões de estatísticas do aplicativo Rotas principais diárias com birth_time, coordenadas e daily_stats_detail
Relatórios gerais periódicos /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly
Relatórios específicos por seção (carreira, saúde, dinheiro, comunicação, amizade, estilo de vida, amor) Rotas por seção em diferentes períodos
Relatórios editoriais focados em planetas Rotas planetárias
Relatórios editoriais focados em aspectos Rotas de aspectos
Relatórios editoriais focados em trânsitos Rotas de trânsitos
Relatórios personalizados focados em casas Rotas de casas
Relatórios personalizados de planetas e casas Rotas de planetas e casas
Mapa astral completo + artefatos de roda Rotas do mapa astral

Mapa de Endpoints

Use este mapa para ir diretamente para a família de rotas exata que seu produto precisa.

Mapa Astral e Fundamentos

Horóscopo Diário

Horóscopo Semanal

Horóscopo Mensal

Horóscopo Anual

Horóscopo de Amor

Relatórios de Planetas, Aspectos, Trânsitos e Casas

Descrições de Sinais do Zodíaco (Não Relatórios Ativos)

Estes /api/v1/horoscope/sign/* endpoints retornam significados de arquétipos de sinais descritivos, e não relatórios astrológicos ativos. Use /api/v1/horoscope/reports/* para geração de relatórios ativos. - Personalidade - Estilo de Comunicação - Amizade e Afinidades - Amor e Sedução - Estilo de Vida e Estética - Saúde e Vitalidade - Espiritualidade e Missão da Alma - Padrões da Sombra - Carreira - Finanças - Pai e Filho

Compatibilidade e Enciclopédia

Ideal Para

  • Aplicativos móveis e web de astrologia
  • Feed e newsletters diárias personalizadas
  • Produtos de compatibilidade e relacionamento
  • Dashboards de bem-estar, coaching e espiritualidade
  • Integrações empresariais que necessitam de repetibilidade determinística

Alimentado por NumerologyAPI.com