Saltar a contenido

Lectura de Tarot con 3 Cartas¶

La Lectura de Tarot con 3 Cartas proporciona información sobre tu Pasado, Presente y Futuro. Extrae tres cartas que reflejan influencias, desafíos y orientación, personalizadas utilizando tu nombre y fecha de nacimiento.

Utiliza esta lectura para obtener claridad, reflexionar sobre patrones y prepararte para los próximos ciclos.

Endpoint¶

Método	Ruta
`GET`	`https://api.numerologyapi.com/api/v1/tarot/reading`
`POST`	`https://api.numerologyapi.com/api/v1/tarot/reading`

Encabezados Requeridos¶

X-API-Key: YOUR_API_KEY
Content-Type: application/json   (POST only)
Host: api.numerologyapi.com

También puedes autenticarte con Authorization: Bearer YOUR_API_KEY.

Crea y gestiona claves de API en el panel de control de Numerology API.

Parámetros¶

Parámetro	Tipo	Requerido	Descripción
`name`	string	Sí	Tu nombre completo. Se utiliza para personalizar la lectura.
`dob`	string	Sí	Fecha de nacimiento en formato `YYYY-MM-DD`.
`mode`	string	No	`random` (predeterminado) o `daily`. El modo diario sembrará la extracción para asegurar las mismas cartas para el mismo día.

Agrega el parámetro de consulta opcional lang para localizar las respuestas. Valores admitidos: en, es, de, fr, pt.

Ejemplos de Solicitudes¶

Solicitud GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?name=John+Doe&dob=1992-07-16&mode=random&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

Solicitud POST (Cuerpo JSON)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/tarot/reading?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "John Doe",
  "dob": "1992-07-16",
  "mode": "random"
}'

Ejemplo de Respuesta¶

{
  "status": "success",
  "mode": "random",
  "name": "john doe",
  "dob": "1992-07-16",
  "timestamp": "2026-02-28T06:36:43.165542",
  "reading": [
    {
      "position": "past",
      "card": "Nine of Wands",
      "reversed": true,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909654/Wands09_REVERSED_c1lzc8.png",
      "meaning": "Reversed, the Nine of Wands suggests burnout, defensiveness, or giving up too soon. Reassess your limits—are you fighting the right battles or exhausting yourself unnecessarily?"
    },
    {
      "position": "present",
      "card": "Queen of Pentacles",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909601/Pentacles13_gcz6tw.png",
      "meaning": "The Queen of Pentacles is nurturing, practical, and abundant. Upright, she embodies care for home, finances, and well-being. She balances work and family effortlessly and offers warmth and security to others."
    },
    {
      "position": "future",
      "card": "Page of Pentacles",
      "reversed": false,
      "image_url": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909597/Pentacles11_hbj9js.png",
      "meaning": "The Page of Pentacles is a messenger of opportunity, learning, and ambition. Upright, it signifies a student mindset, practical planning, and the start of a new venture or career path. You're ready to invest in your goals."
    }
  ],
  "card_backcover": "https://res.cloudinary.com/ds64xs2lp/image/upload/v1746909534/backcover_dgkxji.png",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "20bb36de5d26843f",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "tarot_reading",
    "endpoint_description": "Generates a tarot card reading with interpretations and guidance.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:43.169490+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

Abrir Panel de Control

Nota

mode=daily sembrará las extracciones de cartas en función de tu nombre, fecha de nacimiento y la fecha actual, proporcionando una orientación diaria consistente.
El estado de cada carta reversed puede cambiar su interpretación.
image_url proporciona la ilustración de la carta; card_backcover es la carta inversa genérica.
Las cartas se devuelven en orden de Pasado → Presente → Futuro.

Endpoints Relacionados¶