Ir para o conteúdo

A API de Numerologia v1.0.0

API de Numerologia – Hero

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

  • +203 endpoints documentados em numerologia, horóscopo, astrologia, compatibilidade e ferramentas de divinação
  • Lançamento unificado v1.0.0 com categorias de numerologia expandidas + motor de relatório de horóscopo aprimorado
  • Endpoint público RapidAPI para prototipagem e integração rápida
  • Endpoint de API + painel para integração avançada e de nível empresarial
  • Documentação pronta para desenvolvedores com exemplos de requisições, contratos de parâmetros e padrões de resposta

Destaques da v1.0.0

Este lançamento combina duas funcionalidades principais em uma única versão da plataforma:

  1. Implantação expandida da Numerologia
  2. Adicionadas 23 novas famílias de endpoints e 41 novas operações GET/POST.
  3. Adicionadas novas categorias: Identity & Name, Spiritual & Shadow e Relationship.
  4. Ampliado o escopo de tempo com rotas para semana pessoal e dia/semana/mês/ano universal.
  5. Validado o cobertura multilingue (en, es, de, fr, pt) em 100% na fase de testes de lançamento.

  6. Migração e expansão do motor de Horóscopo

  7. Adicionadas mais de 53 novas endpoints com roteamento de relatórios canônicos padronizado sob /api/v1/horoscope/reports/*.
  8. Expandidas as famílias de relatórios diários/semanais/mensais/anuais e suites especializadas (planetário, aspectos, transitos, casa, planeta-casa).
  9. Melhorado a consistência de requisição/resposta e a paridade de rotas para integrações de produção.

Ler o Changelog completo v1.0.0Ler a Arquitetura do Motor de Horóscopo

Caminhos de Acesso

Caminho Ideal Para Autenticação Notas
RapidAPI (Público) Prototipagem, testes rápidos, integrações públicas menores x-rapidapi-key Rota pública em inglês
API Direta (api.numerologyapi.com) Integrações avançadas, categorias numerológicas estendidas X-API-Key Necessário para famílias de endpoints apenas diretas
Painel (dashboard.numerologyapi.com) Gerenciamento de contas, documentação privada, controles empresariais Login de conta Gestão operacional + recursos empresariais

Categorias Apenas Diretas

Em v1.0.0, estas categorias estão atualmente disponíveis apenas através de acesso direto à API:

  • Identidade e Nome
  • Espiritual e Sombra
  • Relacionamento
  • Ciclos: Semana Pessoal, Dia Universal, Semana Universal, Mês Universal, Ano Universal, Mapa de Calor de Energia Mensal, Calendário de Datas de Cautela
  • Todos os Endpoints de Relatórios de Horóscopo

URL Base: https://api.numerologyapi.com


Mapa de Referência da API


Motor de Horóscopo (Modelo de Produção)

A pilha de horóscopo é determinística e baseada em Swiss Ephemeris, projetada para comportamento de produção real (saídas estáveis, QA reprodutível e design de rotas amigáveis ao cache). - Pilares determinísticos por período (diário, semanal, mensal, anual) - Modo público (baseado em signos) e modo personalizado (consciente dos dados de nascimento) - Conjuntos de relatórios além do horóscopo geral: planetário, aspectos, transitos, casa, planeta-casa - Envoltórios empresariais nas respostas (_enterprise, _api_metadata_) para metadados operacionais

Análise Profunda do MotorVisã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: YOUR_API_KEY"

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: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

Forma da Resposta (exemplo)

{
  "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.0",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

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

  • Mapeie as categorias "v1.0.0" apenas diretas para https://api.numerologyapi.com.
  • Prefira POST para contratos de solicitação mais ricos/aninhados, quando disponíveis.
  • Mantenha as entradas de data/mês normalizadas (YYYY-MM-DD, YYYY-MM).
  • Analise consistentemente _enterprise e _api_metadata_ nos seus modelos de cliente.
  • Para produtos de horóscopo, migre para os endpoints canônicos /api/v1/horoscope/reports/*.

Integração com o Plugin Word

Press

Precisa de uma solução sem código para a entrega do site? Use o plugin oficial Números Core Dakidarts para incorporar formulários, leituras e relatórios diretamente nas páginas do WordPress. - Documentação do Plugin - Instalar do WordPress.org


Próximos Passos