A Numerology API v1.0.2¶

A Numerology API é uma plataforma de nível de produção para construir produtos de numerologia e astrologia com saídas determinísticas, contratos JSON estruturados e ampla cobertura de endpoints.

• Mais de 220 endpoints documentados em numerologia, horóscopo, astrologia, compatibilidade, viagens, educação, legado familiar e ferramentas de adivinhação
• v1.0.2 lançamento atual com 10 novas famílias de endpoints estendidos e cobertura completa em 26 idiomas
• Caminho público RapidAPI para prototipagem rápida e integração
• API direta + painel para integração avançada e de nível empresarial
• Documentação pronta para desenvolvedores com exemplos de requisição, contratos de parâmetros e padrões de resposta
• v1.0.2 lançamento aditivo com 10 novas famílias de endpoints de API direta para marcos de relacionamento, realocação, veículos, adequação de número de telefone, assinaturas, animais de estimação, projetos criativos, legado familiar, caminhos educacionais e alinhamento de destino de viagem
• 26 idiomas de resposta suportados: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
• Suporte a numerologia multi-sistema via num_sys: pythagorean, chaldean e vedic

Destaques da v1.0.2¶

A v1.0.2 é um lançamento aditivo de produção para a Numerology API. Ela se baseia no marco multi-sistema e de 8 idiomas da v1.0.1 já lançada, adicionando mais 10 famílias de endpoints estendidos e expandindo a cobertura de resposta suportada para 26 idiomas.

Este lançamento foca em quatro objetivos principais:

1. Nova cobertura de endpoints estendidos
2. Adiciona 10 novas famílias de endpoints.
3. Cada novo endpoint suporta GET e POST.
4. Todos os novos endpoints usam rotas públicas limpas sob /api/v1/*.
5. Novas famílias de endpoints incluem marcos de relacionamento, realocação, identidade veicular, adequação de telefone, assinaturas, animais de estimação, projetos criativos, legado familiar, caminhos educacionais e alinhamento de destino de viagem.

1. Numerologia multi-sistema continuada
2. Novos endpoints baseados em nome/título/texto suportam num_sys opcional.
3. Sistemas suportados:
   • pythagorean
   • chaldean
   • vedic

4. pythagorean permanece como padrão para preservar o comportamento existente.

5. Cobertura de idiomas expandida

6. A v1.0.1 permanece como o marco de 8 idiomas lançado:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja
7. A v1.0.2 adiciona 18 idiomas adicionais:
   • ru
   • tr
   • it
   • pl
   • nl
   • id
   • ko
   • th
   • ro
   • ur
   • gu
   • bn
   • vi
   • ta
   • te
   • mr
   • pa
   • zh

8. As novas famílias de endpoints incluem arquivos JSON de significados localizados em todos os 26 diretórios de idiomas suportados.

9. Prontidão de documentação e lançamento

10. Adiciona documentação de integração para todas as 10 novas famílias de endpoints.
11. Adiciona um changelog da v1.0.2.
12. Atualiza o índice de Endpoints Estendidos e links de lançamento da referência da API.
13. Expõe os novos endpoints na documentação interna do painel e na descoberta por paleta de comandos.
14. Verifica visibilidade de rotas, cobertura JSON, estrutura de significados localizados e estabilidade do conjunto de testes com Python 3.11.

→ Ler Changelog Completo da v1.0.2

Destaques da v1.0.1¶

A v1.0.1 é um lançamento aditivo de produção para a Numerology API. Ela se baseia no rollout de numerologia estendida da v1.0.0 adicionando leituras mais profundas de nome, timing, negócios, decisão, família, equipe, dinheiro e arquétipos.

Este lançamento foca em quatro objetivos principais:

1. Cobertura de endpoints ampliada
2. Adiciona 10 novas famílias de endpoints.
3. Cada novo endpoint suporta GET e POST.

4. Todos os novos endpoints usam rotas públicas limpas sob /api/v1/*.

5. Numerologia multi-sistema

6. Novos endpoints baseados em nome suportam num_sys opcional.
7. Sistemas suportados:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean permanece como padrão para preservar o comportamento existente.

9. Cobertura de idiomas expandida

10. Idiomas de resposta suportados agora incluem:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. As 10 novas famílias de endpoints incluem arquivos JSON de significados localizados para todos os 8 idiomas suportados.

12. Prontidão de documentação e lançamento

13. Adiciona documentação de integração para todas as 10 novas famílias de endpoints.
14. Atualiza o índice de Endpoints Estendidos.
15. Documenta o comportamento de GET, POST, lang e num_sys.
16. Verifica visibilidade de rotas, cobertura JSON e estabilidade do conjunto de testes com Python 3.11.

→ Ler Changelog Completo da v1.0.1

Destaques da v1.0.0¶

Este lançamento combina duas grandes linhas em uma versão de plataforma:

1. Rollout de Numerologia Estendida
2. Adicionou 23 novas famílias de endpoints e 41 novas operações GET/POST.
3. Adicionou novas categorias: Identidade & Nome, Espiritual & Sombra e Relacionamento.
4. Expandiu a cobertura de timing com rotas de semana pessoal e dia/semana/mês/ano universal.

5. Validou cobertura multilíngue de fumaça (en, es, de, fr, pt) a 100% no QA de lançamento.

6. Migração e expansão do mecanismo de horóscopo

7. Adicionou mais de 53 novos endpoints com roteamento padronizado de relatórios canônicos sob /api/v1/horoscope/reports/*.
8. Expandiu famílias de relatórios diários/semanais/mensais/anuais e conjuntos especializados (planetários, aspectos, trânsitos, casas, planeta-casa).
9. Melhorou a consistência de requisição/resposta e paridade de rotas para integrações de produção.

→ Ler Changelog Completo da v1.0.0 → Ler Arquitetura do Mecanismo de Horóscopo

Caminhos de Acesso¶

Mapa de Referência da API¶

• Visão Geral da Referência da API
• Endpoints Principal
• Ciclos & Trânsitos
• Identidade & Nome
• Espiritual & Sombra
• Relacionamento
• Endpoints Ponte
• Endpoints Kármicos
• Endpoints de Horóscopo
• Outros Endpoints (Tarô / Gematria)

Mecanismo de Horóscopo (Modelo de Produção)¶

A stack de horóscopo é determinística e orientada pelo Swiss Ephemeris, projetada para comportamento real de produção (saídas estáveis, QA reproduzível e design de rota amigável a cache).

• Pilhas de fatores determinísticos por período (diário, semanal, mensal, anual)
• Modo público (baseado em signo) e modo personalizado (com dados de nascimento)
• Conjuntos de relatórios além do horóscopo geral: planetário, aspectos, trânsitos, casas, planeta-casa
• Wrappers empresariais nas respostas (_enterprise, _api_metadata_) para metadados operacionais

→ Mergulho Profundo no Mecanismo → Visão Geral dos Relatórios de Horóscopo

Início Rápido¶

API Direta (recomendada para cobertura avançada)¶

curl "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=en" \
  -H "X-API-Key: SUA_CHAVE_API"

API Direta endpoint estendido v1.0.2¶

curl "https://api.numerologyapi.com/api/v1/relationship-milestone-numerology?person_a_name=Amina%20Bello&person_a_dob=1992-04-18&person_b_name=Jonas%20Meyer&person_b_dob=1990-11-06&milestone_date=2027-06-12&milestone_type=wedding&num_sys=chaldean&lang=fr" \
  -H "X-API-Key: SUA_CHAVE_API"

RapidAPI (rota pública)¶

curl "https://the-numerology-api.p.rapidapi.com/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  -H "x-rapidapi-key: SUA_CHAVE_RAPIDAPI" \
  -H "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

Exemplo de Formato de Resposta¶

{
  "life_path_number": 3,
  "summary": {
    "title": "Life Path 3",
    "overview": "Creative, expressive, and socially magnetic energy pattern."
  },
  "_enterprise": {
    "client": "The Numerology API"
  },
  "_api_metadata_": {
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

Notas de Migração para Integrações Existentes¶

• Direcione categorias exclusivas da API direta v1.0.2 para https://api.numerologyapi.com.
• Prefira POST para contratos de requisição mais ricos/ aninhados quando disponível.
• Use lang em rotas de API direta suportadas para significados JSON localizados no conjunto de 26 idiomas.
• Use num_sys em rotas de numerologia baseadas em nome/título/texto quando precisar de cálculos pythagorean, chaldean ou vedic.
• Mantenha entradas de data/mês normalizadas (YYYY-MM-DD, YYYY-MM).
• Analise _enterprise e _api_metadata_ consistentemente em seus modelos de cliente.
• Para produtos de horóscopo, migre para endpoints canônicos /api/v1/horoscope/reports/*.

Integração com Plugin WordPress¶

Precisa de um caminho sem código para entrega no site? Use o plugin oficial Dakidarts Numerology Core para incorporar formulários, leituras e relatórios diretamente em páginas WordPress.

• Documentação do Plugin
• Instalar do WordPress.org

Próximos Passos¶

• Introdução
• Preços
• Exemplos
• Changelog
• Referência da API