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"}'
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.
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.
