Começando com a API de Numerologia¶

Este guia o guiará através de:

• criação de uma conta de desenvolvedor
• geração de uma chave de API
• compreensão da autenticação
• fazendo seu primeiro pedido de API

A API de Numerologia fornece +184 endpoints prontos para produção, abrangendo:

• cálculos de numerologia
• insights astrológicos
• compatibilidade de signos
• números angelicais
• interpretações de mapa astral

Todos os endpoints suportam respostas em vários idiomas.

1. Crie sua Conta de Desenvolvedor¶

A maneira recomendada de acessar a API de Numerologia é através da plataforma de desenvolvedor oficial.

1. Abra o painel do desenvolvedor https://dashboard.numerologyapi.com

2. Crie sua conta

3. Gere uma chave de API para sua organização

4. Adicione créditos à sua carteira (faturamento por uso)

Sua chave de API terá uma aparência semelhante a:

tnea_xxxxxxxxxxxxxxxxx

2. URL Base¶

Todos os pedidos são enviados para o gateway da API de Numerologia.

Exemplo de endpoint:

https://api.numerologyapi.com/api/v1/life_path

3. Autenticação¶

Cada requisição deve incluir sua chave de API.

x-api-key: YOUR_API_KEY

Exemplos de cabeçalhos de requisição:

GET /api/v1/life_path HTTP/1.1
Host: api.numerologyapi.com
x-api-key: YOUR_API_KEY

4. Primeira Requisição – Número do Caminho de Vida¶

Requisição GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  --header "x-api-key: YOUR_API_KEY"

5. Requisição POST (Corpo JSON)¶

Alguns endpoints também suportam requisições POST.

curl --request POST \
  --url https://api.numerologyapi.com/api/v1/life_path \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
  }'

6. Suporte a Idiomas¶

Todos os endpoints suportam o parâmetro opcional lang.

Exemplo:

?lang=fr

Idiomas suportados:

Exemplo de requisição:

/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=es

7. Exemplos de Código¶

Python (requests)¶

import requests

url = "https://api.numerologyapi.com/api/v1/life_path"

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

headers = {
    "x-api-key": "YOUR_API_KEY"
}

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

print(response.json())

PHP (cURL)¶

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: YOUR_API_KEY"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

?>

Java¶

Script (Fetch)

const url = new URL("https://api.numerologyapi.com/api/v1/life_path");

url.searchParams.append("birth_year", "1990");
url.searchParams.append("birth_month", "5");
url.searchParams.append("birth_day", "15");

fetch(url, {
    method: "GET",
    headers: {
        "x-api-key": "YOUR_API_KEY"
    }
})
.then(r => r.json())
.then(console.log);

Node.js (axios)¶

const axios = require("axios");

axios.get("https://api.numerologyapi.com/api/v1/life_path", {
  params: {
    birth_year: 1990,
    birth_month: 5,
    birth_day: 15
  },
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
.then(res => console.log(res.data));

8. Modelo de Cobrança¶

A NumerologyAPI utiliza um sistema de cobrança baseado em créditos.

1 API request = 1 credit
1 USD = 3,921.57 credits

Os créditos são compartilhados em todos os 203+ endpoints.

Visite Preços para obter detalhes completos.

9. Acesso RapidAPI¶

A API de Numerologia também está disponível no RapidAPI para desenvolvedores que já utilizam esse marketplace.

O RapidAPI requer os seguintes cabeçalhos:

x-rapidapi-key
x-rapidapi-host

---Exemplo de endpoint:

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

Acesse-o aqui:

https://rapidapi.com/dakidarts-dakidarts-default/api/the-numerology-api

10. Próximos Passos¶

Agora que você fez sua primeira solicitação:

• Explore a Referência da API para todos os endpoints
• Revise Preços para entender os créditos
• Verifique o Registro de Mudanças para atualizações

Agora você está pronto para integrar o NumerologyAPI em sua aplicação.