A API de Numerologia v1.0.0¶
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:
- Implantação expandida da Numerologia
- Adicionadas 23 novas famílias de endpoints e 41 novas operações GET/POST.
- Adicionadas novas categorias:
Identity & Name,Spiritual & ShadoweRelationship. - Ampliado o escopo de tempo com rotas para semana pessoal e dia/semana/mês/ano universal.
-
Validado o cobertura multilingue (
en,es,de,fr,pt) em 100% na fase de testes de lançamento. -
Migração e expansão do motor de Horóscopo
- Adicionadas mais de 53 novas endpoints com roteamento de relatórios canônicos padronizado sob
/api/v1/horoscope/reports/*. - Expandidas as famílias de relatórios diários/semanais/mensais/anuais e suites especializadas (planetário, aspectos, transitos, casa, planeta-casa).
- 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.0 → Ler 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 NomeEspiritual e SombraRelacionamentoCiclos: Semana Pessoal, Dia Universal, Semana Universal, Mês Universal, Ano Universal, Mapa de Calor de Energia Mensal, Calendário de Datas de CautelaTodos os Endpoints de Relatórios de Horóscopo
URL Base: https://api.numerologyapi.com
Mapa de Referência da API¶
- Visão Geral da Referência da API
- Endpoints Principais
- Ciclos e Transições
- Identidade e Nome
- Espiritual e Sombra
- Relacionamento
- Endpoints de Ponte
- Endpoints de Karma
- Endpoints de Horóscopo
- Outros Endpoints (Tarot / Gematria)
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 Motor → 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: 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
POSTpara 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
_enterprisee_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