Documentación de Endpoints

Autenticación y Acceso

Para garantizar la seguridad de nuestra infraestructura, todas las peticiones a la API requieren incluir la propiedad Key en el cuerpo del JSON de tu petición POST.

Puedes obtener una clave de desarrollo gratuita registrándote en nuestro plan Hobby. Los clientes del plan Startup y Enterprise también pueden optar por usar autenticación estándar a través de JSON Web Tokens (JWT) pasando un Bearer Token en las cabeceras HTTP.

Campo	Tipo	Requerido	Descripción
`Key`	`string`	Sí	Clave única de API provista a tu cuenta para auditar la cuota y autorizar el consumo de endpoints.

POST /api/astrology/zodiacsigns

¿Para qué sirve?

Devuelve la lista completa de los 12 signos del zodíaco occidental tradicional con sus propiedades principales.

¿Cómo funciona?

Consulta directamente la base de datos de AstroLunae y retorna el nombre de los signos, las fechas de vigencia de sus períodos del año (día y mes), el elemento astrológico asociado (Fuego, Tierra, Aire, Agua) y un icono para pintar en la interfaz.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/zodiacsigns", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/zodiacsigns"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/zodiacsigns"
payload = {
    "Key": "tu_api_key_aqui"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

[
    {
        "sign": "aries",
        "startDay": 21,
        "startMonth": 3,
        "endDay": 19,
        "endMonth": 4,
        "element": "Fuego",
        "icon": "♈"
    },
    ...
]

POST /api/astrology/zodiacsign

¿Para qué sirve?

Determina cuál es el signo zodiacal solar correspondiente a una fecha de nacimiento específica.

¿Cómo funciona?

El backend procesa la fecha de nacimiento ( BirthDate ) provista y evalúa el día y mes de acuerdo con las fronteras astronómicas del zodíaco tropical.

Campo	Tipo	Requerido	Descripción
`BirthDate`	`string (Date)`	Sí	Fecha de nacimiento del usuario en formato `YYYY-MM-DD`.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/zodiacsign", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/zodiacsign"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/zodiacsign"
payload = {
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "sign": "aries",
    "startDay": 21,
    "startMonth": 3,
    "endDay": 19,
    "endMonth": 4,
    "element": "Fuego",
    "icon": "♈"
}

POST /api/astrology/zodiacsign/{name}

¿Para qué sirve?

Obtiene las propiedades y detalles de un signo específico a partir de su nombre en la ruta URL.

¿Cómo funciona?

Extrae la variable {name} de la ruta (valores aceptados: aries, tauro, geminis, cancer, leo, virgo, libra, escorpio, sagitario, capricornio, acuario, piscis) y valida la API key en el cuerpo del request antes de devolver la información.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/zodiacsign/{name}", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/zodiacsign/{name}"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/zodiacsign/{name}"
payload = {
    "Key": "tu_api_key_aqui"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "sign": "aries",
    "startDay": 21,
    "startMonth": 3,
    "endDay": 19,
    "endMonth": 4,
    "element": "Fuego",
    "icon": "♈"
}

POST /api/astrology/horoscope

¿Para qué sirve?

Genera predicciones descriptivas y valoraciones numéricas (porcentajes de suerte) para un signo y frecuencia dados.

¿Cómo funciona?

Combina el signo y la frecuencia. El backend lee nuestro repositorio de más de 1,400 interpretaciones nativas, aplicando un algoritmo rotatorio de frescura para asegurar predicciones que cambian día a día sin ser repetitivas.

Campo	Tipo	Requerido	Descripción
`ZodiacalSign`	`string`	Sí	Nombre del signo en minúsculas (ej: `aries`, `capricornio`).
`Frecuency`	`string`	Sí	Frecuencia temporal de la predicción. Valores permitidos: `daily`, `monthly`, `yearly`.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "ZodiacalSign": "aries",
    "Frecuency": "daily"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"ZodiacalSign\": \"aries\",\n    \"Frecuency\": \"daily\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/horoscope", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"ZodiacalSign\": \"aries\",\n    \"Frecuency\": \"daily\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/horoscope"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/horoscope"
payload = {
    "Key": "tu_api_key_aqui",
    "ZodiacalSign": "aries",
    "Frecuency": "daily"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "sign": "aries",
    "frecuency": "daily",
    "when": "04/07/2026",
    "love": {
        "text": "En el amor, Aries sentirá un impulso muy favorable durante este periodo...",
        "percent": 84
    },
    "work": {
        "text": "Profesionalmente, es el momento idóneo para concretar proyectos...",
        "percent": 75
    },
    "money": {
        "text": "Las finanzas se mantendrán estables siempre que evites gastos...",
        "percent": 68
    },
    "healthy": {
        "text": "Tu vitalidad corporal se mantendrá en niveles óptimos, ideal para...",
        "percent": 90
    },
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/astrology/astralpositions

¿Para qué sirve?

Retorna los tránsitos y las posiciones celestes actuales de los 5 astros principales, con interpretaciones personalizadas según el signo solar del usuario.

¿Cómo funciona?

Determina en tiempo real en qué signos están transitando hoy el Sol, la Luna, Mercurio, Venus y Marte. Compara estas coordenadas con el signo solar del consultante para calcular la Casa Astrológica actual y retornar el impacto psíquico y energético de dicho tránsito.

Campo	Tipo	Requerido	Descripción
`BirthDate`	`string (Date)`	Sí	Fecha de nacimiento del usuario para deducir su signo solar.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/astralpositions", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/astralpositions"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/astralpositions"
payload = {
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "userSign": "aries",
    "queryDate": "2026-07-04",
    "astralPositions": [
        {
            "astroName": "Sol",
            "astroIcon": "☀️",
            "currentSign": "cancer",
            "interpretation": "Sol en Cáncer influye en tu identidad con una sensibilidad protectora. Destaca tu zona del hogar e introspección...",
            "energyLevel": 78
        },
        ...
    ],
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/astrology/compatibility

¿Para qué sirve?

Establece el grado de compatibilidad y sinastría amorosa, laboral y de amistad entre dos personas.

¿Cómo funciona?

Convierte ambas fechas de nacimiento en sus respectivos signos. Luego, el motor astrológico evalúa la relación por afinidad de elementos (ej. Fuego y Aire se potencian, Fuego y Agua se neutralizan) y extrae de la base de datos de sinastría una lectura detallada.

Campo	Tipo	Requerido	Descripción
`BirthDateA`	`string (Date)`	Sí	Fecha de nacimiento de la Persona A en formato `YYYY-MM-DD`.
`BirthDateB`	`string (Date)`	Sí	Fecha de nacimiento de la Persona B en formato `YYYY-MM-DD`.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "BirthDateA": "1995-04-10",
    "BirthDateB": "1998-08-25"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDateA\": \"1995-04-10\",\n    \"BirthDateB\": \"1998-08-25\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/compatibility", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDateA\": \"1995-04-10\",\n    \"BirthDateB\": \"1998-08-25\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/compatibility"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/compatibility"
payload = {
    "Key": "tu_api_key_aqui",
    "BirthDateA": "1995-04-10",
    "BirthDateB": "1998-08-25"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "signA": "aries",
    "signB": "virgo",
    "lovePercent": 64,
    "loveText": "En el plano afectivo, la conexión entre Aries y Virgo destaca por...",
    "workPercent": 78,
    "workText": "Laboralmente, Aries y Virgo funcionan muy bien complementando...",
    "friendshipPercent": 65,
    "friendshipText": "Como amigos, disfrutan de unir la cualidad de la lealtad...",
    "randomVariationCode": 3,
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/astrology/natalchart

¿Para qué sirve?

Retorna las posiciones natales completas de los astros al nacer e interpretaciones asociadas de la personalidad.

¿Cómo funciona?

Basándose en efemérides de alta precisión astronómica que cubren el rango de 1900 a 2050, el backend calcula la posición angular en longitud de los 10 astros principales (Sol, Luna, Mercurio, Venus, Marte, Júpiter, Saturno, Urano, Neptuno, Plutón) al nacer y lee la interpretación natal correspondiente.

Campo	Tipo	Requerido	Descripción
`BirthDate`	`string (Date)`	Sí	Fecha de nacimiento en formato `YYYY-MM-DD`.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/natalchart", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/natalchart"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/natalchart"
payload = {
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "birthDate": "1995-04-10T00:00:00",
    "placements": [
        {
            "astroName": "Sol",
            "astroIcon": "☀️",
            "planetSign": "aries",
            "interpretation": "Nacer con el Sol en Aries te dota de un espíritu pionero, valiente y activo..."
        },
        {
            "astroName": "Luna",
            "astroIcon": "🌙",
            "planetSign": "leo",
            "interpretation": "Tener la Luna en Leo en tu carta natal indica que expresas tus emociones..."
        },
        ...
    ],
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/astrology/chinese

¿Para qué sirve?

Identifica tu signo lunar de la astrología china, tu elemento, polaridad y la interpretación de tu personalidad.

¿Cómo funciona?

A diferencia del cálculo por año calendario común, nuestro algoritmo emplea la fecha exacta del año nuevo lunar (luni-solar chino) para evitar errores con personas nacidas en enero o febrero. Retorna el animal, el elemento (Metal, Agua, Madera, Fuego, Tierra), la polaridad (Yin/Yang), su descripción, colores y números de la suerte.

Campo	Tipo	Requerido	Descripción
`BirthDate`	`string (Date)`	Sí	Fecha de nacimiento en formato `YYYY-MM-DD`.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/astrology/chinese", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/astrology/chinese"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/astrology/chinese"
payload = {
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "birthDate": "1995-04-10T00:00:00",
    "lunarYear": 1995,
    "animal": "Cerdo",
    "element": "Madera",
    "polarity": "Yin",
    "personality": "La combinación de Cerdo y el elemento Madera (Yin) otorga a los nacidos...",
    "compatibility": "Muestras una afinidad natural con el Conejo y la Cabra...",
    "luckyNumbers": "4, 6, 9",
    "luckyColors": "Verde, Azul",
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/tarot/majorarcana

¿Para qué sirve?

Provee el listado completo de los 22 Arcanos Mayores del Tarot con su número, nombre, significados generales e imagen asociada.

¿Cómo funciona?

Retorna directamente las fichas técnicas de la baraja (del Arcano 0 El Loco al Arcano 21 El Mundo) desde la base de datos de AstroLunae.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/tarot/majorarcana", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/tarot/majorarcana"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/tarot/majorarcana"
payload = {
    "Key": "tu_api_key_aqui"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

[
    {
        "id": 0,
        "name": "El Loco",
        "uprightKeywords": "Comienzos, espontaneidad, fe, viaje",
        "reversedKeywords": "Temeridad, ingenuidad, desorganización",
        "description": "El Loco representa los nuevos inicios, dar un salto de fe al vacío..."
    },
    ...
]

POST /api/tarot/threecardspread

¿Para qué sirve?

Genera una tirada clásica de tres cartas para interpretar el Pasado, Presente y Futuro del consultante.

¿Cómo funciona?

El backend baraja los 22 Arcanos, selecciona 3 cartas distintas de manera aleatoria, les asigna una orientación (Derecha o Invertida) mediante cálculo booleano y realiza la lectura combinada del significado contextualizado a su posición temporal.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/tarot/threecardspread", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/tarot/threecardspread"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/tarot/threecardspread"
payload = {
    "Key": "tu_api_key_aqui"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "spreadType": "three_cards",
    "description": "Lectura del Tarot de las 3 Cartas (Pasado, Presente y Futuro)",
    "cards": [
        {
            "position": 1,
            "positionName": "Pasado",
            "cardName": "El Mago",
            "orientation": "Derecha",
            "interpretation": "En el pasado, tu iniciativa y habilidades creativas te permitieron..."
        },
        {
            "position": 2,
            "positionName": "Presente",
            "cardName": "La Sacerdotisa",
            "orientation": "Derecha",
            "interpretation": "En este momento, la vida te pide introspección y silencio..."
        },
        {
            "position": 3,
            "positionName": "Futuro",
            "cardName": "El Sol",
            "orientation": "Invertida",
            "interpretation": "En el porvenir, tu brillo y éxito se verán demorados..."
        }
    ],
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/tarot/celticcross

¿Para qué sirve?

Genera una tirada avanzada y profunda de la Cruz Celta empleando 10 cartas.

¿Cómo funciona?

Selecciona 10 cartas únicas de la baraja y les calcula su sentido (derecha/invertida). Asocia a cada carta una de las 10 posiciones fijas de la tirada (Situación presente, Obstáculo, Meta, Pasado reciente, Raíces, Futuro inmediato, Actitud del consultante, Entorno, Esperanzas/Temores y Desenlace) extrayendo las lecturas específicas del repositorio dinámico.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/tarot/celticcross", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/tarot/celticcross"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/tarot/celticcross"
payload = {
    "Key": "tu_api_key_aqui"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "spreadType": "celtic_cross",
    "description": "Tirada de la Cruz Celta (10 Posiciones)",
    "cards": [
        { "position": 1, "positionName": "Situación Presente", "cardName": "El Loco", "orientation": "Derecha", "interpretation": "Indica un inicio..." },
        { "position": 2, "positionName": "Obstáculo inmediato", "cardName": "La Emperatriz", "orientation": "Invertida", "interpretation": "La falta de..." },
        ...
        { "position": 10, "positionName": "Resultado final", "cardName": "El Mundo", "orientation": "Derecha", "interpretation": "El desenlace..." }
    ],
    "timestamp": "2026-07-04T01:13:20Z"
}

POST /api/numerology/lifepath

¿Para qué sirve?

Calcula el número vital (Camino de la Vida) del consultante a partir de su fecha de nacimiento y genera un reporte numerológico.

¿Cómo funciona?

Suma los dígitos del día, mes y año de nacimiento. Reduce de manera recursiva la suma hasta obtener un solo dígito del 1 al 9, a excepción de que la suma parcial devuelva un número maestro (11, 22 o 33), los cuales no se reducen y adquieren una interpretación de vibración superior. Retorna la personalidad, la misión del destino y recomendaciones laborales y sentimentales.

Campo	Tipo	Requerido	Descripción
`BirthDate`	`string (Date)`	Sí	Fecha de nacimiento en formato `YYYY-MM-DD`.

Petición (Request)

request.json

{
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        var json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await client.PostAsync("https://api.astrolunae.com/api/numerology/lifepath", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String json = "{\n    \"Key\": \"tu_api_key_aqui\",\n    \"BirthDate\": \"1995-04-10\"\n}";
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.astrolunae.com/api/numerology/lifepath"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

import requests

url = "https://api.astrolunae.com/api/numerology/lifepath"
payload = {
    "Key": "tu_api_key_aqui",
    "BirthDate": "1995-04-10"
}
response = requests.post(url, json=payload)
print(response.json())

Respuesta (Response)

response.json

{
    "birthDate": "1995-04-10T00:00:00",
    "numPath": 11,
    "name": "El Mensajero / El Guía Espiritual (Número Maestro)",
    "vibration": "Intuición superior, iluminación, hipersensibilidad, idealismo...",
    "personality": "Las personas con vibración 11 son mensajeros inspirados...",
    "destiny": "Tu misión de vida es servir de faro o guía espiritual...",
    "loveAdvice": "En el terreno amoroso, buscar una profunda fusión...",
    "workAdvice": "Profesionalmente, enfocarte en psicología transpersonal...",
    "timestamp": "2026-07-04T01:13:20Z"
}

Detalle de nuestras APIs Esotéricas

Autenticación y Acceso

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)

¿Para qué sirve?

¿Cómo funciona?

Petición (Request)

Respuesta (Response)