Primeros Pasos con NumerologyAPI¶

Esta guía te acompaña paso a paso para:

• crear una cuenta de desarrollador
• generar una clave API
• comprender la autenticación
• realizar tu primera solicitud a la API

NumerologyAPI ofrece más de 203 endpoints listos para producción que cubren:

• cálculos de numerología
• insights de astrología
• compatibilidad zodiacal
• números angelicales
• interpretaciones del mapa natal

Todos los endpoints admiten respuestas en múltiples idiomas.

1. Crea Tu Cuenta de Desarrollador¶

La forma recomendada de acceder a NumerologyAPI es a través de la plataforma oficial para desarrolladores.

1. Abre el panel de control para desarrolladores https://dashboard.numerologyapi.com

2. Crea tu cuenta

3. Genera una clave API para tu organización

4. Recarga créditos en tu billetera (facturación por uso)

Tu clave API se verá similar a:

tnea_xxxxxxxxxxxxxxxxx

2. URL Base¶

Todas las solicitudes se envían a la pasarela de NumerologyAPI.

Ejemplo de endpoint:

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

3. Autenticación¶

Cada solicitud debe incluir tu clave API.

x-api-key: TU_CLAVE_API

Ejemplo de encabezados de solicitud:

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

4. Primera Solicitud – Número de Camino de Vida¶

Solicitud 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: TU_CLAVE_API"

5. Variante POST (Cuerpo JSON)¶

Algunos endpoints también admiten solicitudes POST.

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

6. Soporte de Idiomas¶

Todos los endpoints admiten el parámetro opcional lang.

Ejemplo:

?lang=es

Idiomas admitidos:

Ejemplo de solicitud:

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

7. Ejemplos 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": "TU_CLAVE_API"
}

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: TU_CLAVE_API"
  ],
]);

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

echo $response;

?>

JavaScript (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": "TU_CLAVE_API"
    }
})
.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": "TU_CLAVE_API"
  }
})
.then(res => console.log(res.data));

8. Modelo de Facturación¶

NumerologyAPI utiliza un sistema de facturación basado en créditos.

1 solicitud API = 1 crédito
1 USD = 3,921.57 créditos

Los créditos se comparten entre todos los más de 203 endpoints.

Visita Precios para obtener detalles completos.

9. Acceso vía RapidAPI¶

La API de Numerología también está disponible en RapidAPI para desarrolladores que ya utilizan ese marketplace.

RapidAPI requiere estos encabezados:

x-rapidapi-key
x-rapidapi-host

Ejemplo de endpoint:

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

Accede aquí:

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

10. Próximos Pasos¶

Ahora que has realizado tu primera solicitud:

• Explora la Referencia de la API para ver todos los endpoints
• Revisa Precios para comprender el sistema de créditos
• Consulta el Registro de Cambios para ver actualizaciones

Ahora estás listo para integrar NumerologyAPI en tu aplicación.