Expansão da Numerologia + Expansão do Horóscopo v1.0.0 – Changelog Unificado¶

Data de lançamento: 2026-04-12 Versão: v1.0.0 Escopo: Lançamento completo da plataforma, abrangendo The Numerology API, Expansão do Horóscopo: incluindo a implantação de endpoints estendidos, migração de relatórios de horóscopo baseados em motor, normalização de solicitações/respostas, paridade da documentação, validação multilingue e orientação de integração para produção.

Visão Geral¶

v1.0.0 é um lançamento de produção importante na plataforma API Dakidarts. Ele reúne duas grandes áreas de trabalho em um único lançamento coordenado:

1. Expansão da Numerologia
2. Adiciona a superfície completa e estendida de numerologia.
3. Expande a cobertura de tempo/ciclo com semana pessoal e dia/semana/mês/ano universal.
4. Introduz endpoints mais profundos para análise espiritual, relacionamento, identidade e sombra.
5. Completa a paridade da documentação, exemplos de respostas e validação multilingue.
6. Expansão do Horóscopo
7. Completa a migração principal da geração de relatórios de horóscopo para o motor Swiss Ephemeris.
8. Padroniza as rotas de relatórios suportadas pelo motor sob /api/v1/horoscope/reports/*.
9. Adiciona cobertura abrangente de seções para períodos diários, semanais, mensais e anuais.
10. Introduz pacotes de relatórios de planetas, aspectos, trânsitos e casas em períodos específicos.
11. Aperfeiçoa a consistência do payload, o comportamento de personalização, os aliases de compatibilidade e a consistência da documentação.

Este changelog tem como objetivo servir como a única fonte de informação para integradores, revisão interna de lançamento, suporte, planejamento de migração e comunicação de lançamento para clientes.

Destaques em Toda a Plataforma¶

O que a versão 1.0.0 oferece na plataforma¶

• Lançamento de produção v1.0.0 para tanto o Numerology API quanto o Horoscope API.
• Expansão significativa da área de endpoints nos produtos de numerologia e horóscopo.
• Conclusão da migração do motor para o cálculo do horóscopo para os principais fluxos de relatórios.
• Conclusão do track de lançamento Numerology Avançado.
• Melhorias nos padrões de requisição estruturada POST para rotas de horóscopo aprimoradas.
• Suporte mais amplo para payloads de resposta ricos, wrappers empresariais e consistência de metadados.
• Maior paridade de documentação entre a documentação pública e payloads de exemplo.
• Validação multilíngue bem-sucedida para endpoints numerológicos avançados.
• Melhoria na clareza das rotas, tratamento de compatibilidade e orientação de migração para clientes de produção.
• Suporte expandido para cálculos personalizados onde vetores de nascimento e campos de requisição avançados são fornecidos.
• Melhoria na clareza operacional em torno de fuso horário, sistema zodiacal, ayanamsa, sistemas de casas e comportamento dos nós nos fluxos de requisição de horóscopo.

Resumo da Composição do Lançamento### Expansão da Numerologia¶

• Novas famílias de endpoints adicionadas: 23
• Operações combinadas adicionadas (GET/POST): 41
• Requisições de validação/teste executadas: 205
• Documentação multilingue de sucesso: 100,0%
• Modelo de lançamento estendido: aditivo, sem depreciações formais na nova suíte estendida

Expansão da Horóscopo¶

• Principais relatórios migrados para o motor interno
• Novas suítes de relatórios adicionadas em:
• planetário
• aspectos
• transitos
• casa
• planeta-casa
• Namespace de relatório canônico estabelecido sob:
• /api/v1/horoscope/reports/*
• Múltiplas rotas legadas mantidas como aliases de compatibilidade ocultas, enquanto a documentação pública avança com os caminhos canônicos

Parte I — API de Numerologia v1.0.0¶

Destaques da Expansão da Numerologia¶

• Adicionado a documentação completa da Numerologia Estendida na seção de documentação estendida.
• Adicionado e completado o Semanal Pessoal, com total compatibilidade GET/POST e suporte para payloads de resposta ricos.
• Adicionado e completado as Extensões do Ciclo Universal:
• Dia Universal
• Semana Universal
• Mês Universal
• Ano Universal
• Padronizado a documentação de endpoints estendidos, incluindo tabelas de parâmetros completas, opções, exemplos de resposta e links para endpoints relacionados.
• Confirmado o teste de cobertura multilingue em en, es, de, fr e pt, com 100% de sucesso para operações estendidas.
• Clarificado o modelo de acesso: os endpoints estendidos são exclusivos da plataforma e atualmente não são suportados através do gateway RapidAPI.

Expansão da Numerologia — Novos Endpoints Adicionados¶

Esta versão adiciona 23 famílias de endpoints estendidos e 41 operações (GET/POST combinadas).

A) Endpoints de Ciclos e Tempo¶

B) Pontos de Extremidade de Inteligência de Identidade e Nome¶

C) Pontos de Extremidade de Análise Espiritual e Sombra¶

D) Pontos de Extremidade de Dinâmica de Relacionamento¶

API de Numerologia — Pontos de Extremidade Atualizados e Corrigidos¶

A) Superfícies Essenciais Estendidas Recém-Concluídas¶

As seguintes superfícies recém-introduzidas foram concluídas de ponta a ponta neste ciclo de lançamento, com validação de solicitações e saída de significado rica:

• GET /api/v1/personal-week
• POST /api/v1/personal-week
• GET /api/v1/universal-year
• POST /api/v1/universal-year
• GET /api/v1/universal-month
• POST /api/v1/universal-month
• GET /api/v1/universal-week
• POST /api/v1/universal-week
• GET /api/v1/universal-day
• POST /api/v1/universal-day### B) Correções de Estabilidade Aplicadas Durante a Validação Inicial

Cinco operações que inicialmente produziam 422 com entradas geradas foram estabilizadas para cobertura de testes semelhantes à produção e agora retornam respostas bem-sucedidas sob entradas multilingues: - POST /api/v1/brand-name-compare - GET /api/v1/caution-dates-calendar - POST /api/v1/caution-dates-calendar - GET /api/v1/monthly-energy-heatmap - POST /api/v1/monthly-energy-heatmap

C) Regras de Validação Práticas Reforçadas¶

The following constraints were tightened and clarified during validation and documentation work:

• A comparação de marcas requer pelo menos duas entradas em names[].
• As entradas de mês e mapa de calor do calendário utilizam o formato YYYY-MM.
• Datas de aviso top_n permanecem restritas ao intervalo 1..31.
• Os payloads do cliente se beneficiam da pré-validação antes da submissão para reduzir erros desnecessários 422 ou erros de nível de formatação.

D) Correções de Paridade entre Documentação e OpenAPI¶

All extended docs were normalized for integration parity:

• complete tabelas de parâmetros por método

• FIM MARKDOWN ---- detalhes da opção do parâmetro

• FIM MARKDOWN ---- padrões, intervalos, valores padrão e campos de objetos aninhados

• Seções de exemplo de resposta rica baseadas em payloads gerados por testes

• notas padronizadas de acesso e disponibilidade

• FIM MARKDOWN ---- CTA do painel, seções de anotações e rodapés de endpoints relacionados

---¶

API de Numerologia — Visão Geral da Verificação de Qualidade¶

Artefatos de validação para o conjunto de numerologia estendido:

• Arquivos de resumo: 23
• Operações testadas: 41
• Número total de requisições executadas: 205
• Taxa de sucesso geral: 100.0%
• Sucesso por idioma:
• en — 100%
• es — 100%
• de — 100%
• fr — 100%
• pt — 100%

Esta versão fecha o ciclo de lançamento do conjunto de numerologia estendido, com confiança de validação em toda a documentação do conjunto de idiomas.

API de Numerologia — Descontinuações¶

Para a versão Numerologia Estendida v1.0.0, nenhum endpoint na superfície estendida é formalmente descontinuado.

API de Numerologia — Mudanças de Quebra¶

Nenhuma remoção de caminho de quebra é introduzida na superfície de numerologia estendida nesta versão.

Dito isto, os integradores devem observar as seguintes expectativas de nível de implantação: - Os endpoints estendidos não estão disponíveis através do RapidAPI neste momento. - Os clientes que integram os endpoints estendidos devem direcionar o host da plataforma diretamente. - Alguns novos endpoints são exclusivamente POST por design e não devem ser assumidos como tendo GET.

API de Numerologia — Notas de Migração¶

1) Migração do Canal de Acesso¶

Os endpoints estendidos estão disponíveis através do acesso direto à plataforma:

• URL base: https://api.numerologyapi.com
• Autenticação:
• X-API-Key: YOUR_API_KEY
• ou Authorization: Bearer YOUR_API_KEY

Os endpoints estendidos não são suportados atualmente através do gateway RapidAPI.

2) Orientação de Uso de GET vs POST¶

A maioria dos endpoints estendidos suporta tanto GET quanto POST com a mesma intenção de saída.

Use:

• GET para chamadas simples baseadas em consulta
• POST para uma estrutura de payload mais forte, objetos aninhados e consistência com SDK/backend

Os endpoints somente POST nesta versão incluem:

• /api/v1/brand-name-compare
• /api/v1/relationship-composite
• /api/v1/relationship-healing-reading
• /api/v1/parent-child-numerology
• /api/v1/soul-connection-indicator

3) Regras de Validação de Entrada no Lado do Cliente¶

Recomendado pré-validação no lado do cliente: - dob e target_date: YYYY-MM-DD - month: YYYY-MM - timezone_offset: String válida de fuso horário IANA - top_n: Inteiro dentro do intervalo 1..31 - names[]: Mínimo de 2 entradas para comparação de marca - context para alinhamento de data: Comprimento máximo 80, aliases normalizados aceitos

4) Padrões de Corpo de Requisição Aninhados¶

Para endpoints de relacionamento e compatibilidade, utilize objetos aninhados explícitos, como:

• person_a
• person_b
• parent
• child

Cada objeto deve conter campos obrigatórios, como:

• full_name
• dob

5) Tratamento de Idiomas e Metadados¶

Endpoints de numerologia estendidos suportam renderização de resposta multilingue via lang.

Conjunto de idiomas suportado para cobertura verificada:

• en
• es
• de
• fr
• pt

As respostas podem incluir wrappers de metadados no estilo empresarial:

• _enterprise
• _api_metadata_

Os clientes devem preservar e analisar esses campos, quando útil para análise de plataforma, informações do plano ou metadados do endpoint.

6) Cobertura de Ciclo Recente¶

Clientes que anteriormente utilizavam apenas fluxos de dia/mês/ano pessoais agora podem estender a lógica de agendamento para cobrir: - Ciclos pessoais semanais via /api/v1/personal-week - Superfícies de sincronização coletiva via: - /api/v1/universal-day - /api/v1/universal-week - /api/v1/universal-month - /api/v1/universal-year

7) Fonte de Documentação Oficial¶

As páginas completas de integração de nível de endpoint para esta versão são mantidas na seção de documentação estendida, incluindo páginas de índice e de endpoint.

API de Numerologia — Lista de Verificação Recomendada de Atualização¶

• Mova chamadas estendidas para acesso direto à API em https://api.numerologyapi.com.
• Garanta que os validadores de requisição apliquem os formatos de data, mês e fuso horário.
• Adicione tratamento de fallback para valores multilingues de lang, quando necessário.
• Atualize os clientes para analisar consistentemente _enterprise e _api_metadata_.
• Para endpoints aninhados, alinhe os modelos de requisição do SDK às chaves de objeto necessárias.
• Valide contra testes de "smoke" antes de promover para produção.
• Confirme que todas as chamadas estendidas são roteadas fora das suposições de clientes baseadas no RapidAPI.

API de Numerologia — Resumo de Notas de Versão¶

A API de Numerologia v1.0.0 introduz a superfície numerológica estendida completa com expansão de ciclos semanais e universais, análises avançadas de relacionamentos e espirituais, contratos de requisição/resposta mais ricos e documentação totalmente sincronizada, além de paridade de testes de "smoke".# Parte II — Expansão de Horóscopo v1.0.0

Destaques da Expansão de Horóscopo¶

• Concluída a migração dos principais fluxos de relatórios de horóscopo para o motor Swiss Ephemeris.
• Padronizados os endpoints de relatórios atualizados em torno de corpos de solicitação POST-first.
• Adicionada cobertura abrangente de seção-first em períodos diários, semanais, mensais e anuais.
• Reestruturados os endpoints de relatórios planetários por período e paridade seção/visão geral.
• Renomeado o endpoint do glossário de planetas para refletir seu comportamento informativo em vez do comportamento de relatório.
• Expandida a paridade de solicitações de mapa astral natal e validado o formato de resposta.
• Normalizadas as respostas de endpoints atualizados para o payload do motor e wrappers de metadados empresariais.
• Atualizados os exemplos de documentação pública com paridade JSON com validação.

Expansão de Horóscopo — Novos Endpoints Adicionados¶

A) Novas Superfícies e Auxiliares¶

• GET /api/v1/horoscope/timezones

B) Suíte de Relatórios Planetários (Superfície Periódica)¶

Seções (não genéricas):

• POST /api/v1/horoscope/reports/planetary/daily
• POST /api/v1/horoscope/reports/planetary/weekly
• POST /api/v1/horoscope/reports/planetary/monthly
• POST /api/v1/horoscope/reports/planetary/yearly

Visão Geral (apenas genérica):

• POST /api/v1/horoscope/reports/planetary/daily/overview
• POST /api/v1/horoscope/reports/planetary/weekly/overview
• POST /api/v1/horoscope/reports/planetary/monthly/overview
• POST /api/v1/horoscope/reports/planetary/yearly/overview

A cobertura expandida das seções planetárias em períodos inclui seções suportadas pelo motor, como: - communication - friendship - lifestyle - career - health - money - love_singles - love_couples

C) Conjunto de Relatórios de Aspecto (Superfície Periódica)¶

Seções (não genéricas):

• POST /api/v1/horoscope/reports/aspects/daily
• POST /api/v1/horoscope/reports/aspects/weekly
• POST /api/v1/horoscope/reports/aspects/monthly
• POST /api/v1/horoscope/reports/aspects/yearly

Visão geral (apenas genérica):

• POST /api/v1/horoscope/reports/aspects/daily/overview
• POST /api/v1/horoscope/reports/aspects/weekly/overview
• POST /api/v1/horoscope/reports/aspects/monthly/overview
• POST /api/v1/horoscope/reports/aspects/yearly/overview

aspects/* suporta:

• modo público
• modo personalizado
• sobreposição determinística opcional de aspect
• o mesmo modelo de seção usado nas rotas de horóscopo atualizadas

D) Conjunto de Relatórios de Trânsito (Superfície Periódica)¶

Seções (não genéricas):

• POST /api/v1/horoscope/reports/transits/daily
• POST /api/v1/horoscope/reports/transits/weekly
• POST /api/v1/horoscope/reports/transits/monthly
• POST /api/v1/horoscope/reports/transits/yearly

Visão geral (apenas genérica):

• POST /api/v1/horoscope/reports/transits/daily/overview
• POST /api/v1/horoscope/reports/transits/weekly/overview
• POST /api/v1/horoscope/reports/transits/monthly/overview
• POST /api/v1/horoscope/reports/transits/yearly/overview

transits/* suporta:

• modo público
• modo personalizado
• sobreposição determinística opcional de transit
• o mesmo modelo de seção usado nas rotas de horóscopo atualizadas

E) Conjunto de Relatórios de Casas (Apenas Personalizado, Superfície Periódica)¶

Relatórios de casas (seções não genéricas):

• POST /api/v1/horoscope/reports/house/daily
• POST /api/v1/horoscope/reports/house/weekly
• POST /api/v1/horoscope/reports/house/monthly
• POST /api/v1/horoscope/reports/house/yearly

Visões gerais de casas (apenas genéricas):

• POST /api/v1/horoscope/reports/house/daily/overview
• POST /api/v1/horoscope/reports/house/weekly/overview
• POST /api/v1/horoscope/reports/house/monthly/overview
• POST /api/v1/horoscope/reports/house/yearly/overview

Relatórios de planeta-casa (seções não genéricas):

• POST /api/v1/horoscope/reports/planet/house/daily
• POST /api/v1/horoscope/reports/planet/house/weekly
• POST /api/v1/horoscope/reports/planet/house/monthly

• POST /api/v1/horoscope/reports/planet/house/yearlyVisões gerais das casas planetárias:

• POST /api/v1/horoscope/reports/planet/house/daily/overview

• POST /api/v1/horoscope/reports/planet/house/weekly/overview
• POST /api/v1/horoscope/reports/planet/house/monthly/overview
• POST /api/v1/horoscope/reports/planet/house/yearly/overview

Ambas as famílias de rotas são exclusivamente para personalização e são suportadas por endpoints do motor, como:

• /house-horoscope
• /planet-house-horoscope

F) Canonicalização do Namespace de Relatórios¶

Os caminhos de relatórios "live" agora utilizam o namespace /api/v1/horoscope/reports/* nas superfícies de horóscopo suportadas pelo motor, após a atualização.

Caminhos de relatórios não padrão permanecem registrados como aliases de compatibilidade ocultos.

G) Novas Famílias de Rotas de Seção de Horóscopo Adicionadas¶

Comunicação¶

• POST /api/v1/horoscope/reports/communication/daily/today
• POST /api/v1/horoscope/reports/communication/daily/tomorrow
• POST /api/v1/horoscope/reports/communication/daily/yesterday
• POST /api/v1/horoscope/reports/communication/weekly
• POST /api/v1/horoscope/reports/communication/monthly
• POST /api/v1/horoscope/reports/communication/yearly

Amizade¶

• POST /api/v1/horoscope/reports/friendship/daily/today
• POST /api/v1/horoscope/reports/friendship/daily/tomorrow
• POST /api/v1/horoscope/reports/friendship/daily/yesterday
• POST /api/v1/horoscope/reports/friendship/weekly
• POST /api/v1/horoscope/reports/friendship/monthly
• POST /api/v1/horoscope/reports/friendship/yearly

Estilo de Vida¶

• POST /api/v1/horoscope/reports/lifestyle/daily/today
• POST /api/v1/horoscope/reports/lifestyle/daily/tomorrow
• POST /api/v1/horoscope/reports/lifestyle/daily/yesterday
• POST /api/v1/horoscope/reports/lifestyle/weekly
• POST /api/v1/horoscope/reports/lifestyle/monthly
• POST /api/v1/horoscope/reports/lifestyle/yearly

Superfícies de Divórcio (Solteiros/Casados)¶

• POST /api/v1/horoscope/reports/love_singles/daily/today
• POST /api/v1/horoscope/reports/love_singles/daily/tomorrow
• POST /api/v1/horoscope/reports/love_singles/daily/yesterday
• POST /api/v1/horoscope/reports/love_singles/weekly
• POST /api/v1/horoscope/reports/love_singles/monthly
• POST /api/v1/horoscope/reports/love_couples/daily/today
• POST /api/v1/horoscope/reports/love_couples/daily/tomorrow
• POST /api/v1/horoscope/reports/love_couples/daily/yesterday
• POST /api/v1/horoscope/reports/love_couples/weekly
• POST /api/v1/horoscope/reports/love_couples/monthly

Adições de Seção Anual¶

• POST /api/v1/horoscope/reports/health/yearly
• POST /api/v1/horoscope/reports/money/yearly

H) Superfície de Planetas Informativos Renomeada¶

• GET /api/v1/horoscope/planets-info
• POST /api/v1/horoscope/planets-info

Isso substitui a nomenclatura anterior /horoscope/planets para o comportamento de glossário.

Expansão do Horóscopo — Pontos de Fim Atualizados e Corrigidos¶

A) Migração e Atualizações de Comportamento do Motor¶

As seguintes famílias de rotas existentes foram atualizadas para o comportamento baseado no motor interno:

Rotas principais de relatórios¶

• POST /api/v1/horoscope/reports/today
• POST /api/v1/horoscope/reports/yesterday
• POST /api/v1/horoscope/reports/tomorrow
• POST /api/v1/horoscope/reports/weekly
• POST /api/v1/horoscope/reports/monthly
• POST /api/v1/horoscope/reports/yearly

Rotas de categoria existentes atualizadas do comportamento legado do horoscope.com¶

• carreira
• saúde
• amor
• dinheiro

Famílias existentes e legadas reestruturadas e atualizadas¶

• Rotas de amor legadas divididas em love_singles e love_couples
• Comportamento combinado de yearly/career_money substituído por rotas dedicadas de carreira anual e dinheiro anual
• Rotas de relatórios e visão geral planetária legadas movidas para rotas periódicas

B) Clarificação da Rota de Descrição do Signo Zodiacal¶

As seguintes superfícies permanecem como pontos de fim descritivos, e não como pontos de fim de relatórios em tempo real:

• /api/v1/horoscope/sign/personality
• /api/v1/horoscope/sign/communication
• /api/v1/horoscope/sign/friendship
• /api/v1/horoscope/sign/love
• /api/v1/horoscope/sign/lifestyle
• /api/v1/horoscope/sign/health
• /api/v1/horoscope/sign/career
• /api/v1/horoscope/sign/money
• /api/v1/horoscope/sign/parent_child
• /api/v1/horoscope/sign/spirituality
• /api/v1/horoscope/sign/shadow

C) Atualização de Paridade do Horóscopo de Aniversário¶

POST /api/v1/horoscope/reports/birthday agora expõe chaves de solicitação nativas do motor, mantendo as chaves de compatibilidade.

Superfície canônica atualizada:

• POST /api/v1/horoscope/reports/birthday

Aliases de compatibilidade ocultas mantidas: - /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday

Chaves de requisição nativas do motor expostas:

• sign
• target_date
• birth
• sections
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id

Chaves de compatibilidade mantidas:

• dob
• timezone
• year
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

D) Atualização de Paridade do Mapa Astral Natal¶

Estas superfícies existiam antes da versão 1.0.0 e agora foram atualizadas para maior compatibilidade com o motor:

• POST /api/v1/birth-chart
• POST /api/v1/birth-chart/svg

As melhorias incluem:

• Suporte completo para a opção de requisição de gateway para o motor
• Paridade do campo de configuração do "wheel"
• Guardas mais rigorosas para a forma da resposta

E) Normalização do Contrato de Resposta¶

Endpoints de motor de horóscopo atualizados retornam:

• Payload de resposta do motor bruto
• _enterprise
• _api_metadata_

F) Tratamento de Fuso Horário e Data Relativa¶

Endpoints diários que utilizam today, yesterday e tomorrow agora aplicam a resolução de data de destino com conhecimento de fuso horário através da entrada de fuso horário IANA.

G) Clarificação do Suporte à Personalização¶

Quando suportado, os relatórios personalizados são ativados fornecendo campos de vetor de nascimento, como:

• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

Se omitidos, as rotas permanecem utilizáveis no modo genérico baseado em signos.

Expansão do Horóscopo — Pontos de Fim Depreciados, Ocultos e Removidos¶

Expansão do Horóscopo — Mudanças Incompatíveis¶

• Renomeamento da rota: /api/v1/horoscope/planets → /api/v1/horoscope/planets-info
• O namespace canônico para relatórios de horóscopo baseados em engine agora é /api/v1/horoscope/reports/*
• Rotas diárias de amor combinadas foram substituídas por caminhos explícitos para solteiros e casais.
• A rota anual career_money combinada foi removida em favor de rotas anuais dedicadas.
• Pontos de extremidade genéricos para relatórios e visão geral planetária foram desativados em favor de rotas estruturadas por período.
• Rotas baseadas em engine atualizadas são padronizadas em torno de corpos de solicitação POST.

Expansão do Horóscopo — Notas de Compatibilidade¶

• Rotas legadas /api/v1/horoscope/report/* permanecem disponíveis como aliases ocultos e compatíveis com versões anteriores.
• A documentação pública e a OpenAPI agora apresentam apenas o namespace canônico /api/v1/horoscope/reports/*.
• Novas integrações devem adotar os caminhos /reports/* imediatamente.

Expansão do Horóscopo — Notas de Migração¶

1) Mapa de Migração de Caminho de Endpoint¶

• GET/POST /api/v1/horoscope/planets → GET/POST /api/v1/horoscope/planets-info
• POST /api/v1/horoscope/report/{surface} → POST /api/v1/horoscope/reports/{surface}
• POST /api/v1/horoscope/{surface} → POST /api/v1/horoscope/reports/{surface}
• POST /api/v1/horoscope/planetary/overview → POST /api/v1/horoscope/reports/planetary/{period}/overview
• Rota de agregação planetária antiga → POST /api/v1/horoscope/reports/planetary/{period} ou rota equivalente de visão geral
• Rota de agregação flexível planetária antiga → rotas específicas de seção ou rotas de visão geral
• POST /api/v1/horoscope/yearly/career_money → dividir em rotas anuais de carreira e rotas anuais de dinheiro
• Rotas diárias de amor antigas → dividir em rotas diárias love_singles ou love_couples

2) Migração do Payload de Requisição¶

Para rotas suportadas por um motor aprimorado, utilize corpos POST estruturados com campos como:

• dob
• timezone
• Seletores de período, como day, target_date ou year
• Opções opcionais do motor:
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id
• Campos de personalização opcionais:
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

3) Regras de Migração da Rota Planetária¶

• Utilize sections apenas em rotas planetárias de período que não são de visão geral.
• general está disponível através de rotas dedicadas /overview.

4) Migração do Parser de Resposta¶

Os clientes devem analisar:

• Campos do payload de relatório diretamente do corpo da resposta.
• _enterprise
• _api_metadata_

5) Nota sobre o Comportamento de Tradução¶

The horoscope engine itself does not generate multilingual content directly, so report based endpoints currently support but en only.

Non-report endpoints continue to support full multilingual translation through gateway helper layers using lang, such as:

• en
• es
• de
• fr
• pt

Expansão do Horóscopo — Documentação e Paridade de Qualidade Concluídas¶

• Documentação pública atualizada para rotas de horóscopo aprimoradas

• Documentação planetária antiga substituída por documentação planetária específica por período

• Documentação de carreira e finanças dividida, removendo rotas combinadas

• Exemplo JSON com suporte de "Smoke" sincronizado com as respostas do endpoint para documentação aprimorada

---¶

Expansão do Horóscopo — Lista de Verificação de Atualização Recomendada para o Cliente¶

• Atualizar todas as rotas renomeadas e obsoletas utilizando o mapa de migração

• Mude qualquer consumidor legado de rotas de relatórios GET para requisições de corpo POST

• FIM MARKDOWN ---- Adicionar fuso horário a todos os fluxos diários para evitar o deslocamento de datas relativas

• Adicione campos de personalização onde são desejadas editoriais específicas para o usuário

• FIM MARKDOWN ---- Atualizar os analisadores de resposta para manter _enterprise e _api_metadata_- Executar novamente os testes de integração contra todos os endpoints de horóscopo utilizados em produção

- FIM MARKDOWN ---¶

Resumo das Notas de Lançamento — Expansão do Horóscopo¶

A API de Numerologia v1.0.0 completa uma implantação principal com total compatibilidade, expande a cobertura de relatórios em seções e períodos, introduz uma estrutura de rota canônica mais limpa e estabelece uma superfície de produção mais clara para futuras iterações do motor de horóscopo interno.

Parte III — Orientações de Integração entre APIs¶

Notas de Integração Unificadas para Clientes que Utilizam a API de Numerologia¶

Clientes que consomem tanto os endpoints de Numerologia quanto os de Horóscopo devem revisar os seguintes pontos em conjunto:

Autenticação e Acesso¶

• Os endpoints de Numerologia estendidos são apenas para plataformas (sem suporte para gateway RapidAPI)
• As rotas de horóscopo, que são suportadas pelo motor, também são apenas para plataformas e continuam sob seu namespace de API canônico com padrões de gateway atualizados
• Mantenha o suporte para wrappers de metadados de estilo empresarial

Modelagem de Solicitações¶

• Prefira corpos de POST estruturados explicitamente para todas as rotas recém-atualizadas ou expandidas
• Valide formatos de data, seletores de período, strings de fuso horário e objetos aninhados no lado do cliente
• Sempre que possível, forneça vetores de personalização para resultados mais ricos### Fuso Horário e Semântica da Data
• Os endpoints da Numerologia dependem de formatos de data e mês corretos.
• As rotas diárias do Horóscopo dependem do tratamento correto do fuso horário para a resolução de datas relativas.
• As strings de fuso horário IANA são fortemente recomendadas, quando suportadas.

Tratamento de Idiomas¶

• Os endpoints estendidos da Numerologia possuem renderização multilingue com verificação de qualidade.
• As rotas do Horóscopo, suportadas pelo Engine, continuam a suportar apenas en.

Recomendações para Implantação em Produção¶

• Atualize primeiro os SDKs e os validadores de requisições.
• Refresque em seguida os testes de integração.
• Em seguida, promova as alterações de rotas/caminhos para os clientes de produção.
• Monitore quaisquer aliases de compatibilidade ocultos que ainda estejam em uso internamente, para que possam ser desativados com confiança posteriormente.

Parte IV — Resumo da Versão Final¶

O que v1.0.0 significa¶

v1.0.0 é o ponto em que ambas as superfícies se tornam substancialmente mais completas e adequadas para produção: - Numerology API agora expõe um catálogo muito mais rico e abrangente, que abrange horários, identidade, insights espirituais, trabalho com sombras, relacionamentos, compatibilidade e calendários preditivos. - Relatórios de Horóscopo agora se baseiam em uma base muito mais sólida, com namespaces de relatórios canônicos, cobertura de seções mais ampla, padrões de migração mais claros e melhor compatibilidade entre as famílias de relatórios. - A documentação, exemplos, comportamento de validação e orientação de compatibilidade são significativamente mais maduros do que no estado pré-v1.0.0.

Esta versão não é apenas um aumento de versão. É uma versão estrutural que melhora:

• completude da plataforma
• clareza das rotas
• prontidão para migração do cliente
• confiança na documentação
• consistência na integração empresarial

Recomendação Operacional¶

Para todos os integradores ativos, o caminho recomendado é:

1. adotar rotas canônicas imediatamente
2. atualizar os modelos de requisição para payloads POST-first, quando aplicável
3. preservar a análise do wrapper de metadados
4. validar formatos de fuso horário/data no lado do cliente
5. mover os consumidores estendidos de Numerology para acesso direto à plataforma
6. executar novamente a cobertura completa de integração antes do lançamento em produção

Nota Final¶

This unified changelog reflects the v1.0.0 release state for The Numerology API and consolidates the major rollout work completed for the 2026-04-12 release window.