POST/api/astro/tarot/yes-no/1 crédito

Tarot de sí o no

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.

https://api.occultapi.com/api/astro/tarot/yes-no/

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.
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/yes-no/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Should I take the offer?","seed":"sample-yesno"}'

Respuesta

{
  "data": {
    "question": "Should I take the offer?",
    "seed": "sample-yesno",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 14,
        "name": "Temperance",
        "arcana": "major",
        "suit": null,
        "rank": null,
        "number": 14,
        "element": null,
        "upright": "balance, moderation, patience, blending",
        "reversed": "imbalance, excess, impatience",
        "orientation": "upright",
        "meaning": "balance, moderation, patience, blending",
        "yes_no": "yes"
      }
    ],
    "answer": "yes",
    "card": "Temperance",
    "orientation": "upright",
    "meaning": "balance, moderation, patience, blending",
    "how_decided": "Each card has a traditional leaning. A reversal flips yes to no and no to yes; an ambivalent card stays ambivalent. Conventions differ between readers, so this one is stated rather than left implicit."
  },
  "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.