curl -X POST https://api.occultapi.com/api/astro/tarot/yes-no/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"Should I take the offer?","seed":"sample-yesno"}'
Una carta sacada para una pregunta, interpretada como sí, no o quizá.
La respuesta indica explícitamente cómo se ha decidido, porque las convenciones varían de un lector a otro y un simple «sí» no dice cuál se ha aplicado. Cada carta tiene una inclinación tradicional: el Sol y el As de Copas tienden al sí, la Torre y el Nueve de Espadas tienden al no, y el Dos de Espadas y el Siete de Copas son ambivalentes. Una inversión convierte un sí en no y un no en sí; una carta ambivalente sigue siéndolo en cualquier orientación. Pon `allow_reversed` como false para leer solo cartas al derecho.
La carta y todas sus palabras clave se devuelven con el veredicto, porque un «no» por sí solo no es una lectura y es la carta la que lleva el significado.
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.
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.
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.