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¶

As seguintes restrições foram reforçadas e esclarecidas durante o trabalho de validação e documentação:

• 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¶

Toda a documentação estendida foi normalizada para paridade de integração:

• tabelas de parâmetros completas por método
• detalhes das opções de parâmetros
• 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
• 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/yearly

Visõ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¶

O motor de horóscopo não gera conteúdo multilíngue diretamente, portanto, os endpoints baseados em relatórios atualmente suportam apenas en.

Os endpoints que não são de relatórios continuam a suportar tradução multilíngue completa através das camadas auxiliares do gateway usando lang, como:

• 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
• 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
• 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

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¶

Este changelog unificado reflete o estado de lançamento v1.0.0 para The Numerology API e consolida o grande trabalho de implantação concluído para a janela de lançamento 2026-04-12.

• Changelog Unificado v1.0.1