Ir para o conteúdo

Getting Started

Começando com a API de Numerologia – Tutorial de Início Rápido

Bem-vindo à API de Numerologia! Este guia abrangente o ajudará a ir de zero para o seu primeiro cálculo numerológico bem-sucedido em poucos minutos. Seja você construindo um aplicativo de numerologia, um site de astrologia, uma plataforma de horóscopo diário ou uma ferramenta de bem-estar espiritual, nossa API com mais de 100 endpoints facilita a adição de insights numerológicos de alta qualidade.

Por que escolher a API de Numerologia?

  • +100 Endpoints: Calcule o Número do Caminho de Vida, o Número de Destino/Expressão, o Desejo do Coração (Impulso da Alma), o Número de Personalidade, o Número de Atitude, a Dívida Karmica, as Lições Karmicas, o Ano Pessoal, os Ciclos Essenciais, as Expressões Menores, os Números de Ponte e muito mais.
  • Sistema de Numerologia Pitagórica: Cálculos precisos e testados ao longo do tempo, com significados detalhados e suporte para números mestres (11, 22, 33).
  • Hospedado no RapidAPI: Assinatura simples, tempo de atividade confiável e planos de preços escaláveis (nível gratuito disponível).
  • Amigável para Desenvolvedores: Suporta métodos GET e POST, respostas JSON e integração fácil em qualquer linguagem.

Passo a Passo: Inscreva-se e Obtenha sua Chave de API

  1. Visite o oficial The Numerology API on RapidAPI
  2. Clique em "Assinar Teste" e escolha um plano:
  3. Básico (Gratuito) – 100 solicitações/mês – perfeito para testes
  4. Pro – 130.000 solicitações/mês
  5. Ultra (Recomendado) – 550.000 solicitações/mês
  6. Mega – 2.000.000 solicitações/mês
  7. Após a assinatura, copie sua X-RapidAPI-Key da aba "Endpoints".

Sua Primeira Solicitação: Calcular o Número do Caminho de Vida

O Número do Caminho de Vida é um dos números mais importantes na numerologia. Veja como calculá-lo usando o endpoint GET.

Exemplo em Python

import requests

url = "https://the-numerology-api.p.rapidapi.com/life_path"

# Example: Birth date May 15, 1990
querystring = {
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY_HERE",
    "X-RapidAPI-Host": "the-numerology-api.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

if response.status_code == 200:
    data = response.json()
    print(f"Life Path Number: {data['life_path_number']}")
    print(f"Summary: {data['summary']}")
    print(f"Detailed Meaning: {data['detailed_meaning']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

Saída Esperada (para 1997-08-17): 

{
  "life_path_number": 11,
  "summary": "The life path number 11 is a master number that represents intuition, spirituality, and enlightenment...",
  "detailed_meaning": "Master Number 11 represents intuition, inspiration, and spiritual insight..."
}

Exemplo em JavaScript (Fetch)

const url = "https://the-numerology-api.p.rapidapi.com/life_path";

const options = {
  method: 'GET',
  headers: {
    'X-RapidAPI-Key': 'YOUR_API_KEY_HERE',
    'X-RapidAPI-Host': 'the-numerology-api.p.rapidapi.com'
  },
  // Query parameters
  // Add as URL search params
};

fetch(`${url}?birth_year=1990&birth_month=5&birth_day=15`, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Alternativa de Requisição POST (Corpo JSON)

Muitos endpoints suportam GET e POST. Aqui está a versão POST para o Número do Caminho de Vida:

payload = {
    "birth_year": 1990,
    "birth_month": 5,
    "birth_day": 15
}

response = requests.post(url, json=payload, headers=headers)

Erros Comuns e Solução de Problemas

  • 401 Unauthorized: Verifique sua chave de API e status de assinatura.
  • 400 Bad Request: Verifique se os parâmetros necessários estão presentes e formatados corretamente.
  • 429 Too Many Requests: Você excedeu o limite do seu plano – atualize para mais solicitações.

O que vem a seguir?

Agora que você fez sua primeira chamada, explore estes endpoints populares:

Navegue pela API Reference para descobrir todos os +100 endpoints.

Está pronto para criar algo incrível? Comece a integrar cálculos de numerologia, recursos de astrologia e horóscopos personalizados hoje mesmo!

Tags: #numerologyapi #lifepathnumber #destinynumber #numerologytutorial #pythonapi #rapidapi #espiritualapp #astrologyapi #horoscopeapi #gettingstarted #pythagoreannumerology #masternumbers