POST/api/astro/tarot/draw/1 crédito

Sacar cartas de tarot

Saca cartas de una baraja Rider-Waite-Smith barajada de setenta y ocho cartas. Las cartas se sacan sin reposición, así que ninguna se repite en la misma tirada. Cada una se devuelve con su arcano, palo, rango, número, orientación y las palabras clave estándar según cómo haya salido. Cada respuesta incluye el `seed` que la produjo, y volver a enviar esa semilla reproduce la tirada exactamente: mismas cartas, mismo orden, misma orientación. Si lo omites, se genera uno y se devuelve, así que por defecto la tirada es nueva y siempre se puede repetir después. Esto es lo que permite a un cliente guardar una lectura y volver a mostrarla en lugar de darle al consultante una respuesta distinta a la misma pregunta. `allow_reversed` y `reversal_chance` existen porque cada lector trabaja a su manera: algunos trabajan solo con cartas al derecho, otros invierten aproximadamente la mitad de la baraja y otros, muchas menos.

https://api.occultapi.com/api/astro/tarot/draw/

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
allow_reversed	boolean	opcional	Si las cartas pueden salir invertidas. Algunos lectores trabajan solo con cartas al derecho.
count	integer	opcional	Cuántas cartas sacar, como máximo 21. Las cartas se sacan sin reposición, así que ninguna puede repetirse. min 1 · max 21
question	string	opcional	Opcional. Se devuelve tal cual y se incorpora a una semilla generada.
reversal_chance	number (double)	opcional	Probabilidad de que una carta salga invertida, cuando se permiten las inversiones. min 0 · max 1
seed	string	opcional	Envía una semilla para reproducir exactamente una tirada. Si la omites, se genera una y se devuelve, así que cualquier tirada se puede repetir después.

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/tarot/draw/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"What should I focus on this month?","count":3,"seed":"sample-draw"}'

Respuesta

{
  "data": {
    "question": "What should I focus on this month?",
    "seed": "sample-draw",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 50,
        "name": "Ace of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ace",
        "number": 1,
        "element": "air",
        "upright": "clarity, breakthrough, truth cutting through",
        "reversed": "confusion, a truth misused",
        "orientation": "reversed",
        "meaning": "confusion, a truth misused",
        "yes_no": "no"
      },
      {
        "position": 2,
        "id": 32,
        "name": "Page of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Page",
        "number": 11,
        "element": "fire",
        "upright": "curiosity, an idea, enthusiasm",
        "reversed": "unfocused energy, an idea unformed",
        "orientation": "reversed",
        "meaning": "unfocused energy, an idea unformed",
        "yes_no": "no"
      },
      {
        "position": 3,
        "id": 31,
        "name": "Ten of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Ten",
        "number": 10,
        "element": "fire",
        "upright": "burden, overload, carrying too much",
        "reversed": "putting a load down, delegation",
        "orientation": "upright",
        "meaning": "burden, overload, carrying too much",
        "yes_no": "no"
      }
    ],
    "count": 3
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.